@xopcai/xopc 0.0.102 → 0.0.104

package/dist/src/agent/skills/marketplace/adapters/store/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","names":[],"sources":["../../../../../../../src/agent/skills/marketplace/adapters/store/adapter.ts"],"sourcesContent":["import {\n  downloadSkillZipBuffer,\n  fetchMarketplacePackageDetail,\n  listSkillPackages,\n  resolveSkillZipDownloadUrl,\n  resolveSkillsStoreBaseUrl,\n  skillIdForMarketplaceInstall,\n} from './store-api-client.js';\n\nimport type { SkillsMarketplaceAdapter } from '../../adapter.types.js';\nimport { registerMarketplaceAdapter } from '../../registry.js';\n\nexport const storeMarketplaceAdapter: SkillsMarketplaceAdapter = {\n  id: 'store',\n\n  async listCategories(_config) {\n    return [];\n  },\n\n  async listPackages(config, params) {\n    const base = resolveSkillsStoreBaseUrl(config);\n    const response = await listSkillPackages(base, params);\n    return {\n      items: response.items,\n      meta: response.meta,\n      provider: 'store',\n    };\n  },\n\n  async getPackageDetail(config, packageName) {\n    const base = resolveSkillsStoreBaseUrl(config);\n    const detail = await fetchMarketplacePackageDetail(base, packageName);\n    return { ...detail, provider: 'store' };\n  },\n\n  async downloadPackage(config, packageName, version) {\n    const base = resolveSkillsStoreBaseUrl(config);\n    const { downloadUrl, version: resolvedVersion } = await resolveSkillZipDownloadUrl(\n      base,\n      packageName,\n      version,\n    );\n    const buffer = await downloadSkillZipBuffer(base, downloadUrl);\n    return {\n      buffer,\n      skillId: skillIdForMarketplaceInstall(packageName) ?? packageName,\n      version: resolvedVersion,\n    };\n  },\n};\n\n// Self-register into the dynamic marketplace adapter registry.\nregisterMarketplaceAdapter({\n  adapter: storeMarketplaceAdapter,\n  displayName: 'XOPC Store',\n});\n"],"mappings":";;;AAYA,MAAa,0BAAoD;CAC/D,IAAI;CAEJ,MAAM,eAAe,SAAS;AAC5B,SAAO,EAAE;;CAGX,MAAM,aAAa,QAAQ,QAAQ;EAEjC,MAAM,WAAW,MAAM,kBADV,0BAA0B,OACM,EAAE,OAAO;AACtD,SAAO;GACL,OAAO,SAAS;GAChB,MAAM,SAAS;GACf,UAAU;GACX;;CAGH,MAAM,iBAAiB,QAAQ,aAAa;AAG1C,SAAO;GAAE,GAAG,MADS,8BADR,0BAA0B,OACgB,EAAE,YAAY;GACjD,UAAU;GAAS;;CAGzC,MAAM,gBAAgB,QAAQ,aAAa,SAAS;EAClD,MAAM,OAAO,0BAA0B,OAAO;EAC9C,MAAM,EAAE,aAAa,SAAS,oBAAoB,MAAM,2BACtD,MACA,aACA,QACD;AAED,SAAO;GACL,QAAA,MAFmB,uBAAuB,MAAM,YAAY;GAG5D,SAAS,6BAA6B,YAAY,IAAI;GACtD,SAAS;GACV;;CAEJ;AAGD,2BAA2B;CACzB,SAAS;CACT,aAAa;CACd,CAAC"}
+{"version":3,"file":"adapter.js","names":[],"sources":["../../../../../../../src/agent/skills/marketplace/adapters/store/adapter.ts"],"sourcesContent":["import { buildSkillMarkdownPreviewFromRaw } from '../../../skill-markdown-preview-from-raw.js';\nimport {\n  downloadSkillZipBuffer,\n  fetchMarketplacePackageDetail,\n  listSkillPackages,\n  resolveSkillZipDownloadUrl,\n  resolveSkillsStoreBaseUrl,\n  skillIdForMarketplaceInstall,\n} from './store-api-client.js';\n\nimport type { SkillsMarketplaceAdapter } from '../../adapter.types.js';\nimport { registerMarketplaceAdapter } from '../../registry.js';\n\nexport const storeMarketplaceAdapter: SkillsMarketplaceAdapter = {\n  id: 'store',\n\n  async listCategories(_config) {\n    return [];\n  },\n\n  async listPackages(config, params) {\n    const base = resolveSkillsStoreBaseUrl(config);\n    const response = await listSkillPackages(base, params);\n    return {\n      items: response.items,\n      meta: response.meta,\n      provider: 'store',\n    };\n  },\n\n  async getPackageDetail(config, packageName) {\n    const base = resolveSkillsStoreBaseUrl(config);\n    const detail = await fetchMarketplacePackageDetail(base, packageName);\n    const readme = detail.readme?.trim();\n    if (!readme) {\n      throw new Error(`Store skill package [${packageName}] did not include readme`);\n    }\n    return {\n      ...detail,\n      readme,\n      provider: 'store',\n      skillDocPreview: buildSkillMarkdownPreviewFromRaw(readme, {\n        name: detail.name,\n        description: detail.description,\n      }),\n    };\n  },\n\n  async downloadPackage(config, packageName, version) {\n    const base = resolveSkillsStoreBaseUrl(config);\n    const { downloadUrl, version: resolvedVersion } = await resolveSkillZipDownloadUrl(\n      base,\n      packageName,\n      version,\n    );\n    const buffer = await downloadSkillZipBuffer(base, downloadUrl);\n    return {\n      buffer,\n      skillId: skillIdForMarketplaceInstall(packageName) ?? packageName,\n      version: resolvedVersion,\n    };\n  },\n};\n\n// Self-register into the dynamic marketplace adapter registry.\nregisterMarketplaceAdapter({\n  adapter: storeMarketplaceAdapter,\n  displayName: 'XOPC Store',\n});\n"],"mappings":";;;;AAaA,MAAa,0BAAoD;CAC/D,IAAI;CAEJ,MAAM,eAAe,SAAS;AAC5B,SAAO,EAAE;;CAGX,MAAM,aAAa,QAAQ,QAAQ;EAEjC,MAAM,WAAW,MAAM,kBADV,0BAA0B,OACM,EAAE,OAAO;AACtD,SAAO;GACL,OAAO,SAAS;GAChB,MAAM,SAAS;GACf,UAAU;GACX;;CAGH,MAAM,iBAAiB,QAAQ,aAAa;EAE1C,MAAM,SAAS,MAAM,8BADR,0BAA0B,OACgB,EAAE,YAAY;EACrE,MAAM,SAAS,OAAO,QAAQ,MAAM;AACpC,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,wBAAwB,YAAY,0BAA0B;AAEhF,SAAO;GACL,GAAG;GACH;GACA,UAAU;GACV,iBAAiB,iCAAiC,QAAQ;IACxD,MAAM,OAAO;IACb,aAAa,OAAO;IACrB,CAAC;GACH;;CAGH,MAAM,gBAAgB,QAAQ,aAAa,SAAS;EAClD,MAAM,OAAO,0BAA0B,OAAO;EAC9C,MAAM,EAAE,aAAa,SAAS,oBAAoB,MAAM,2BACtD,MACA,aACA,QACD;AAED,SAAO;GACL,QAAA,MAFmB,uBAAuB,MAAM,YAAY;GAG5D,SAAS,6BAA6B,YAAY,IAAI;GACtD,SAAS;GACV;;CAEJ;AAGD,2BAA2B;CACzB,SAAS;CACT,aAAa;CACd,CAAC"}

package/dist/src/agent/skills/marketplace/adapters/store/store-api-client.d.ts

@@ -127,8 +127,8 @@ export interface UnifiedMarketplaceListResponse {
  */
 export interface UnifiedMarketplacePackageDetail extends MarketplacePackageDetail {
     provider: string;
-    /** When set (e.g. SkillHub SKILL.md), gateway console renders structured meta + body like installed skills. */
-    skillDocPreview?: SkillMarkdownPreviewPayload;
+    /** Gateway-normalized structured meta + body rendered by the console. */
+    skillDocPreview: SkillMarkdownPreviewPayload;
     /** SkillHub-specific fields */
     skillHubInfo?: {
         category: string;

package/dist/src/agent/skills/marketplace/adapters/store/store-api-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"store-api-client.js","names":[],"sources":["../../../../../../../src/agent/skills/marketplace/adapters/store/store-api-client.ts"],"sourcesContent":["/**\n * HTTP client for the public xopc-store-compatible REST API (packages list, detail, zip download).\n * Used by the store marketplace adapter and SSRF-safe download helpers.\n *\n * Facade: {@link ../../../skills-marketplace.js}.\n */\n\nimport type { Config } from '../../../../../config/schema.js';\nimport { MAX_EXTENSION_STORE_ZIP_BYTES } from '../../../../../extensions/store-zip-limits.js';\nimport { isValidSkillId, MAX_SKILL_ZIP_BYTES } from '../../../managed-store.js';\nimport type { SkillMarkdownPreviewPayload } from '../../../types.js';\n\nconst DEFAULT_STORE_BASE = 'https://store.xopc.ai';\n\n/**\n * Marketplace provider identifier. Dynamic — extensions can register additional providers\n * via `api.registerMarketplaceAdapter()`. Built-in values: 'store', 'skillhub', 'clawhub'.\n */\nexport type SkillsMarketplaceProvider = string;\n\nexport interface SkillsStoreListParams {\n  q?: string;\n  page?: number;\n  pageSize?: number;\n  sort?: 'downloads' | 'newest';\n  /** Adapter-defined category id (exact match against package `categories`). */\n  category?: string;\n}\n\n/** Category option for marketplace filter chips (from adapter). */\nexport interface MarketplaceCategoryOption {\n  id: string;\n  label: string;\n}\n\n/** Mirrors xopc-store GET /api/v1/packages list response (subset used by UI). */\nexport interface SkillsStorePackageListItem {\n  id: string;\n  name: string;\n  type: string;\n  description: string;\n  downloads: number;\n  author: { username: string; avatarUrl: string | null };\n  latestVersion?: string;\n  updatedAt: string;\n  /** Taxonomy / tags from the marketplace (adapter-specific). */\n  categories?: string[];\n  tags?: string[];\n  stars?: number;\n  /** Short provenance label for the row (e.g. ClawHub). */\n  sourceLabel?: string;\n}\n\n/** Unified marketplace package list item (works for all adapters). */\nexport type MarketplacePackageListItem = SkillsStorePackageListItem;\n\nexport interface SkillsStoreListResponse {\n  items: SkillsStorePackageListItem[];\n  meta: { page: number; pageSize: number; total: number; totalPages: number };\n}\n\nexport function resolveSkillsStoreBaseUrl(config: Config): string {\n  const env = process.env.XOPC_SKILLS_STORE_URL?.trim();\n  if (env) {\n    try {\n      return normalizeBaseUrl(new URL(env).toString());\n    } catch {\n      // fall through\n    }\n  }\n  const fromConfig = config.gateway?.skillsStoreBaseUrl?.trim();\n  if (fromConfig) {\n    try {\n      return normalizeBaseUrl(new URL(fromConfig).toString());\n    } catch {\n      return DEFAULT_STORE_BASE;\n    }\n  }\n  return DEFAULT_STORE_BASE;\n}\n\nexport { MAX_EXTENSION_STORE_ZIP_BYTES };\n\n/**\n * Base URL for extension downloads (defaults to skills store host — usually store.xopc.ai).\n * Override with `XOPC_EXTENSIONS_STORE_URL`.\n */\nexport function resolveExtensionsStoreBaseUrl(config: Config): string {\n  const env = process.env.XOPC_EXTENSIONS_STORE_URL?.trim();\n  if (env) {\n    try {\n      return normalizeBaseUrl(new URL(env).toString());\n    } catch {\n      // fall through\n    }\n  }\n  return resolveSkillsStoreBaseUrl(config);\n}\n\nfunction normalizeBaseUrl(url: string): string {\n  return url.replace(/\\/$/, '');\n}\n\nexport function getStoreOrigin(baseUrl: string): string {\n  const u = new URL(baseUrl);\n  return `${u.protocol}//${u.host}`;\n}\n\n/**\n * Allow download URLs whose origin matches the configured store base (SSRF guard).\n * Production store is HTTPS-only; local dev (`http://localhost` / `127.0.0.1`) may use HTTP.\n */\nexport function assertDownloadUrlAllowed(downloadUrl: string, storeBaseUrl: string): URL {\n  let u: URL;\n  try {\n    u = new URL(downloadUrl);\n  } catch {\n    throw new Error('Invalid download URL from store');\n  }\n  const allowed = new URL(storeBaseUrl);\n  const localHttpDev =\n    allowed.protocol === 'http:' &&\n    (allowed.hostname === 'localhost' || allowed.hostname === '127.0.0.1');\n  if (localHttpDev) {\n    if (u.protocol !== 'http:' && u.protocol !== 'https:') {\n      throw new Error('Download URL must use HTTP or HTTPS');\n    }\n  } else if (u.protocol !== 'https:') {\n    throw new Error('Download URL must use HTTPS');\n  }\n  if (u.host !== allowed.host) {\n    throw new Error('Download URL host does not match configured store host');\n  }\n  return u;\n}\n\nasync function fetchJson<T>(url: string, init?: RequestInit): Promise<T> {\n  const res = await fetch(url, {\n    ...init,\n    headers: { Accept: 'application/json', ...init?.headers },\n  });\n  const text = await res.text();\n  if (!res.ok) {\n    let msg = `Store request failed (${res.status})`;\n    try {\n      const j = JSON.parse(text) as { error?: { message?: string } };\n      if (j.error?.message) msg = j.error.message;\n    } catch {\n      if (text) msg = text.slice(0, 200);\n    }\n    throw new Error(msg);\n  }\n  try {\n    return JSON.parse(text) as T;\n  } catch {\n    throw new Error('Store returned invalid JSON');\n  }\n}\n\nexport async function listSkillPackages(\n  storeBaseUrl: string,\n  params: SkillsStoreListParams,\n): Promise<SkillsStoreListResponse> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  const sp = new URLSearchParams();\n  sp.set('type', 'skill');\n  if (params.q?.trim()) sp.set('q', params.q.trim());\n  if (params.page != null) sp.set('page', String(params.page));\n  if (params.pageSize != null) sp.set('pageSize', String(params.pageSize));\n  if (params.sort) sp.set('sort', params.sort);\n  if (params.category?.trim()) sp.set('category', params.category.trim());\n\n  const url = `${base}/api/v1/packages?${sp.toString()}`;\n  return fetchJson<SkillsStoreListResponse>(url);\n}\n\n/** GET /api/v1/packages/:name — published skill package (public). */\nexport interface MarketplacePackageDetail {\n  id: string;\n  name: string;\n  type: string;\n  description: string;\n  readme: string | null;\n  downloads: number;\n  author: { username: string; avatarUrl: string | null };\n  latestVersion: {\n    version: string;\n    changelog: string | null;\n    publishedAt: string;\n  };\n}\n\nexport async function fetchMarketplacePackageDetail(\n  storeBaseUrl: string,\n  packageName: string,\n): Promise<MarketplacePackageDetail> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  const enc = encodeURIComponent(packageName.trim());\n  return fetchJson<MarketplacePackageDetail>(`${base}/api/v1/packages/${enc}`);\n}\n\nexport async function resolveSkillZipDownloadUrl(\n  storeBaseUrl: string,\n  packageName: string,\n  version?: string,\n): Promise<{ downloadUrl: string; version: string }> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  const enc = encodeURIComponent(packageName);\n  if (version?.trim()) {\n    const v = encodeURIComponent(version.trim());\n    const detail = await fetchJson<{\n      downloadUrl: string;\n      version: string;\n    }>(`${base}/api/v1/packages/${enc}/versions/${v}`);\n    if (!detail.downloadUrl) {\n      throw new Error('Store version has no download URL');\n    }\n    assertDownloadUrlAllowed(detail.downloadUrl, base);\n    return { downloadUrl: detail.downloadUrl, version: detail.version };\n  }\n\n  const pkg = await fetchJson<{\n    name: string;\n    latestVersion: { downloadUrl: string; version: string };\n  }>(`${base}/api/v1/packages/${enc}`);\n  if (!pkg.latestVersion?.downloadUrl) {\n    throw new Error('Package has no published version');\n  }\n  assertDownloadUrlAllowed(pkg.latestVersion.downloadUrl, base);\n  return {\n    downloadUrl: pkg.latestVersion.downloadUrl,\n    version: pkg.latestVersion.version,\n  };\n}\n\nexport async function downloadSkillZipBuffer(\n  storeBaseUrl: string,\n  downloadUrl: string,\n): Promise<Buffer> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  assertDownloadUrlAllowed(downloadUrl, base);\n\n  const res = await fetch(downloadUrl, { redirect: 'follow' });\n  if (!res.ok) {\n    throw new Error(`Failed to download skill archive (${res.status})`);\n  }\n  const len = res.headers.get('content-length');\n  if (len) {\n    const n = Number(len);\n    if (Number.isFinite(n) && n > MAX_SKILL_ZIP_BYTES) {\n      throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);\n    }\n  }\n  const ab = await res.arrayBuffer();\n  const buf = Buffer.from(ab);\n  if (buf.length > MAX_SKILL_ZIP_BYTES) {\n    throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);\n  }\n  return buf;\n}\n\n/** GET /api/v1/packages/:name — subset used for extension installs. */\nexport interface StorePublishedPackageHead {\n  name: string;\n  type: string;\n  latestVersion: {\n    version: string;\n    downloadUrl: string;\n  };\n}\n\nexport async function resolveExtensionZipDownloadUrl(\n  storeBaseUrl: string,\n  packageName: string,\n  version?: string,\n): Promise<{ downloadUrl: string; version: string }> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  const enc = encodeURIComponent(packageName.trim());\n  const meta = await fetchJson<StorePublishedPackageHead>(`${base}/api/v1/packages/${enc}`);\n  if (meta.type !== 'extension') {\n    throw new Error(\n      `Package \"${packageName}\" has type \"${meta.type}\" (expected extension). ` +\n        'Use `xopc skills install` for skills.',\n    );\n  }\n  if (version?.trim()) {\n    const v = encodeURIComponent(version.trim());\n    const detail = await fetchJson<{ downloadUrl: string; version: string }>(\n      `${base}/api/v1/packages/${enc}/versions/${v}`,\n    );\n    if (!detail.downloadUrl) {\n      throw new Error('Store version has no download URL');\n    }\n    assertDownloadUrlAllowed(detail.downloadUrl, base);\n    return { downloadUrl: detail.downloadUrl, version: detail.version };\n  }\n  const lv = meta.latestVersion;\n  if (!lv?.downloadUrl) {\n    throw new Error('Package has no published version');\n  }\n  assertDownloadUrlAllowed(lv.downloadUrl, base);\n  return { downloadUrl: lv.downloadUrl, version: lv.version };\n}\n\nexport async function downloadExtensionStoreZipBuffer(\n  storeBaseUrl: string,\n  downloadUrl: string,\n): Promise<Buffer> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  assertDownloadUrlAllowed(downloadUrl, base);\n  const res = await fetch(downloadUrl, { redirect: 'follow' });\n  if (!res.ok) {\n    throw new Error(`Failed to download extension archive (${res.status})`);\n  }\n  const len = res.headers.get('content-length');\n  if (len) {\n    const n = Number(len);\n    if (Number.isFinite(n) && n > MAX_EXTENSION_STORE_ZIP_BYTES) {\n      throw new Error(`Zip exceeds maximum size (${MAX_EXTENSION_STORE_ZIP_BYTES} bytes)`);\n    }\n  }\n  const ab = await res.arrayBuffer();\n  const buf = Buffer.from(ab);\n  if (buf.length > MAX_EXTENSION_STORE_ZIP_BYTES) {\n    throw new Error(`Zip exceeds maximum size (${MAX_EXTENSION_STORE_ZIP_BYTES} bytes)`);\n  }\n  return buf;\n}\n\nexport function skillIdForMarketplaceInstall(packageName: string): string | undefined {\n  const trimmed = packageName.trim();\n  if (!trimmed) return undefined;\n  return isValidSkillId(trimmed) ? trimmed : undefined;\n}\n\n/**\n * Unified marketplace list response (adapter fills `provider`).\n */\nexport interface UnifiedMarketplaceListResponse {\n  items: MarketplacePackageListItem[];\n  meta: { page: number; pageSize: number; total: number; totalPages: number };\n  provider: string;\n}\n\n/**\n * Unified marketplace package detail response.\n */\nexport interface UnifiedMarketplacePackageDetail extends MarketplacePackageDetail {\n  provider: string;\n  /** When set (e.g. SkillHub SKILL.md), gateway console renders structured meta + body like installed skills. */\n  skillDocPreview?: SkillMarkdownPreviewPayload;\n  /** SkillHub-specific fields */\n  skillHubInfo?: {\n    category: string;\n    installs: number;\n    stars: number;\n    securityReports?: {\n      keen?: { status: string; statusText: string; reportUrl?: string };\n      sanbu?: { status: string; statusText: string; reportUrl?: string };\n    };\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"store-api-client.js","names":[],"sources":["../../../../../../../src/agent/skills/marketplace/adapters/store/store-api-client.ts"],"sourcesContent":["/**\n * HTTP client for the public xopc-store-compatible REST API (packages list, detail, zip download).\n * Used by the store marketplace adapter and SSRF-safe download helpers.\n *\n * Facade: {@link ../../../skills-marketplace.js}.\n */\n\nimport type { Config } from '../../../../../config/schema.js';\nimport { MAX_EXTENSION_STORE_ZIP_BYTES } from '../../../../../extensions/store-zip-limits.js';\nimport { isValidSkillId, MAX_SKILL_ZIP_BYTES } from '../../../managed-store.js';\nimport type { SkillMarkdownPreviewPayload } from '../../../types.js';\n\nconst DEFAULT_STORE_BASE = 'https://store.xopc.ai';\n\n/**\n * Marketplace provider identifier. Dynamic — extensions can register additional providers\n * via `api.registerMarketplaceAdapter()`. Built-in values: 'store', 'skillhub', 'clawhub'.\n */\nexport type SkillsMarketplaceProvider = string;\n\nexport interface SkillsStoreListParams {\n  q?: string;\n  page?: number;\n  pageSize?: number;\n  sort?: 'downloads' | 'newest';\n  /** Adapter-defined category id (exact match against package `categories`). */\n  category?: string;\n}\n\n/** Category option for marketplace filter chips (from adapter). */\nexport interface MarketplaceCategoryOption {\n  id: string;\n  label: string;\n}\n\n/** Mirrors xopc-store GET /api/v1/packages list response (subset used by UI). */\nexport interface SkillsStorePackageListItem {\n  id: string;\n  name: string;\n  type: string;\n  description: string;\n  downloads: number;\n  author: { username: string; avatarUrl: string | null };\n  latestVersion?: string;\n  updatedAt: string;\n  /** Taxonomy / tags from the marketplace (adapter-specific). */\n  categories?: string[];\n  tags?: string[];\n  stars?: number;\n  /** Short provenance label for the row (e.g. ClawHub). */\n  sourceLabel?: string;\n}\n\n/** Unified marketplace package list item (works for all adapters). */\nexport type MarketplacePackageListItem = SkillsStorePackageListItem;\n\nexport interface SkillsStoreListResponse {\n  items: SkillsStorePackageListItem[];\n  meta: { page: number; pageSize: number; total: number; totalPages: number };\n}\n\nexport function resolveSkillsStoreBaseUrl(config: Config): string {\n  const env = process.env.XOPC_SKILLS_STORE_URL?.trim();\n  if (env) {\n    try {\n      return normalizeBaseUrl(new URL(env).toString());\n    } catch {\n      // fall through\n    }\n  }\n  const fromConfig = config.gateway?.skillsStoreBaseUrl?.trim();\n  if (fromConfig) {\n    try {\n      return normalizeBaseUrl(new URL(fromConfig).toString());\n    } catch {\n      return DEFAULT_STORE_BASE;\n    }\n  }\n  return DEFAULT_STORE_BASE;\n}\n\nexport { MAX_EXTENSION_STORE_ZIP_BYTES };\n\n/**\n * Base URL for extension downloads (defaults to skills store host — usually store.xopc.ai).\n * Override with `XOPC_EXTENSIONS_STORE_URL`.\n */\nexport function resolveExtensionsStoreBaseUrl(config: Config): string {\n  const env = process.env.XOPC_EXTENSIONS_STORE_URL?.trim();\n  if (env) {\n    try {\n      return normalizeBaseUrl(new URL(env).toString());\n    } catch {\n      // fall through\n    }\n  }\n  return resolveSkillsStoreBaseUrl(config);\n}\n\nfunction normalizeBaseUrl(url: string): string {\n  return url.replace(/\\/$/, '');\n}\n\nexport function getStoreOrigin(baseUrl: string): string {\n  const u = new URL(baseUrl);\n  return `${u.protocol}//${u.host}`;\n}\n\n/**\n * Allow download URLs whose origin matches the configured store base (SSRF guard).\n * Production store is HTTPS-only; local dev (`http://localhost` / `127.0.0.1`) may use HTTP.\n */\nexport function assertDownloadUrlAllowed(downloadUrl: string, storeBaseUrl: string): URL {\n  let u: URL;\n  try {\n    u = new URL(downloadUrl);\n  } catch {\n    throw new Error('Invalid download URL from store');\n  }\n  const allowed = new URL(storeBaseUrl);\n  const localHttpDev =\n    allowed.protocol === 'http:' &&\n    (allowed.hostname === 'localhost' || allowed.hostname === '127.0.0.1');\n  if (localHttpDev) {\n    if (u.protocol !== 'http:' && u.protocol !== 'https:') {\n      throw new Error('Download URL must use HTTP or HTTPS');\n    }\n  } else if (u.protocol !== 'https:') {\n    throw new Error('Download URL must use HTTPS');\n  }\n  if (u.host !== allowed.host) {\n    throw new Error('Download URL host does not match configured store host');\n  }\n  return u;\n}\n\nasync function fetchJson<T>(url: string, init?: RequestInit): Promise<T> {\n  const res = await fetch(url, {\n    ...init,\n    headers: { Accept: 'application/json', ...init?.headers },\n  });\n  const text = await res.text();\n  if (!res.ok) {\n    let msg = `Store request failed (${res.status})`;\n    try {\n      const j = JSON.parse(text) as { error?: { message?: string } };\n      if (j.error?.message) msg = j.error.message;\n    } catch {\n      if (text) msg = text.slice(0, 200);\n    }\n    throw new Error(msg);\n  }\n  try {\n    return JSON.parse(text) as T;\n  } catch {\n    throw new Error('Store returned invalid JSON');\n  }\n}\n\nexport async function listSkillPackages(\n  storeBaseUrl: string,\n  params: SkillsStoreListParams,\n): Promise<SkillsStoreListResponse> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  const sp = new URLSearchParams();\n  sp.set('type', 'skill');\n  if (params.q?.trim()) sp.set('q', params.q.trim());\n  if (params.page != null) sp.set('page', String(params.page));\n  if (params.pageSize != null) sp.set('pageSize', String(params.pageSize));\n  if (params.sort) sp.set('sort', params.sort);\n  if (params.category?.trim()) sp.set('category', params.category.trim());\n\n  const url = `${base}/api/v1/packages?${sp.toString()}`;\n  return fetchJson<SkillsStoreListResponse>(url);\n}\n\n/** GET /api/v1/packages/:name — published skill package (public). */\nexport interface MarketplacePackageDetail {\n  id: string;\n  name: string;\n  type: string;\n  description: string;\n  readme: string | null;\n  downloads: number;\n  author: { username: string; avatarUrl: string | null };\n  latestVersion: {\n    version: string;\n    changelog: string | null;\n    publishedAt: string;\n  };\n}\n\nexport async function fetchMarketplacePackageDetail(\n  storeBaseUrl: string,\n  packageName: string,\n): Promise<MarketplacePackageDetail> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  const enc = encodeURIComponent(packageName.trim());\n  return fetchJson<MarketplacePackageDetail>(`${base}/api/v1/packages/${enc}`);\n}\n\nexport async function resolveSkillZipDownloadUrl(\n  storeBaseUrl: string,\n  packageName: string,\n  version?: string,\n): Promise<{ downloadUrl: string; version: string }> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  const enc = encodeURIComponent(packageName);\n  if (version?.trim()) {\n    const v = encodeURIComponent(version.trim());\n    const detail = await fetchJson<{\n      downloadUrl: string;\n      version: string;\n    }>(`${base}/api/v1/packages/${enc}/versions/${v}`);\n    if (!detail.downloadUrl) {\n      throw new Error('Store version has no download URL');\n    }\n    assertDownloadUrlAllowed(detail.downloadUrl, base);\n    return { downloadUrl: detail.downloadUrl, version: detail.version };\n  }\n\n  const pkg = await fetchJson<{\n    name: string;\n    latestVersion: { downloadUrl: string; version: string };\n  }>(`${base}/api/v1/packages/${enc}`);\n  if (!pkg.latestVersion?.downloadUrl) {\n    throw new Error('Package has no published version');\n  }\n  assertDownloadUrlAllowed(pkg.latestVersion.downloadUrl, base);\n  return {\n    downloadUrl: pkg.latestVersion.downloadUrl,\n    version: pkg.latestVersion.version,\n  };\n}\n\nexport async function downloadSkillZipBuffer(\n  storeBaseUrl: string,\n  downloadUrl: string,\n): Promise<Buffer> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  assertDownloadUrlAllowed(downloadUrl, base);\n\n  const res = await fetch(downloadUrl, { redirect: 'follow' });\n  if (!res.ok) {\n    throw new Error(`Failed to download skill archive (${res.status})`);\n  }\n  const len = res.headers.get('content-length');\n  if (len) {\n    const n = Number(len);\n    if (Number.isFinite(n) && n > MAX_SKILL_ZIP_BYTES) {\n      throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);\n    }\n  }\n  const ab = await res.arrayBuffer();\n  const buf = Buffer.from(ab);\n  if (buf.length > MAX_SKILL_ZIP_BYTES) {\n    throw new Error(`Zip exceeds maximum size (${MAX_SKILL_ZIP_BYTES} bytes)`);\n  }\n  return buf;\n}\n\n/** GET /api/v1/packages/:name — subset used for extension installs. */\nexport interface StorePublishedPackageHead {\n  name: string;\n  type: string;\n  latestVersion: {\n    version: string;\n    downloadUrl: string;\n  };\n}\n\nexport async function resolveExtensionZipDownloadUrl(\n  storeBaseUrl: string,\n  packageName: string,\n  version?: string,\n): Promise<{ downloadUrl: string; version: string }> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  const enc = encodeURIComponent(packageName.trim());\n  const meta = await fetchJson<StorePublishedPackageHead>(`${base}/api/v1/packages/${enc}`);\n  if (meta.type !== 'extension') {\n    throw new Error(\n      `Package \"${packageName}\" has type \"${meta.type}\" (expected extension). ` +\n        'Use `xopc skills install` for skills.',\n    );\n  }\n  if (version?.trim()) {\n    const v = encodeURIComponent(version.trim());\n    const detail = await fetchJson<{ downloadUrl: string; version: string }>(\n      `${base}/api/v1/packages/${enc}/versions/${v}`,\n    );\n    if (!detail.downloadUrl) {\n      throw new Error('Store version has no download URL');\n    }\n    assertDownloadUrlAllowed(detail.downloadUrl, base);\n    return { downloadUrl: detail.downloadUrl, version: detail.version };\n  }\n  const lv = meta.latestVersion;\n  if (!lv?.downloadUrl) {\n    throw new Error('Package has no published version');\n  }\n  assertDownloadUrlAllowed(lv.downloadUrl, base);\n  return { downloadUrl: lv.downloadUrl, version: lv.version };\n}\n\nexport async function downloadExtensionStoreZipBuffer(\n  storeBaseUrl: string,\n  downloadUrl: string,\n): Promise<Buffer> {\n  const base = normalizeBaseUrl(storeBaseUrl);\n  assertDownloadUrlAllowed(downloadUrl, base);\n  const res = await fetch(downloadUrl, { redirect: 'follow' });\n  if (!res.ok) {\n    throw new Error(`Failed to download extension archive (${res.status})`);\n  }\n  const len = res.headers.get('content-length');\n  if (len) {\n    const n = Number(len);\n    if (Number.isFinite(n) && n > MAX_EXTENSION_STORE_ZIP_BYTES) {\n      throw new Error(`Zip exceeds maximum size (${MAX_EXTENSION_STORE_ZIP_BYTES} bytes)`);\n    }\n  }\n  const ab = await res.arrayBuffer();\n  const buf = Buffer.from(ab);\n  if (buf.length > MAX_EXTENSION_STORE_ZIP_BYTES) {\n    throw new Error(`Zip exceeds maximum size (${MAX_EXTENSION_STORE_ZIP_BYTES} bytes)`);\n  }\n  return buf;\n}\n\nexport function skillIdForMarketplaceInstall(packageName: string): string | undefined {\n  const trimmed = packageName.trim();\n  if (!trimmed) return undefined;\n  return isValidSkillId(trimmed) ? trimmed : undefined;\n}\n\n/**\n * Unified marketplace list response (adapter fills `provider`).\n */\nexport interface UnifiedMarketplaceListResponse {\n  items: MarketplacePackageListItem[];\n  meta: { page: number; pageSize: number; total: number; totalPages: number };\n  provider: string;\n}\n\n/**\n * Unified marketplace package detail response.\n */\nexport interface UnifiedMarketplacePackageDetail extends MarketplacePackageDetail {\n  provider: string;\n  /** Gateway-normalized structured meta + body rendered by the console. */\n  skillDocPreview: SkillMarkdownPreviewPayload;\n  /** SkillHub-specific fields */\n  skillHubInfo?: {\n    category: string;\n    installs: number;\n    stars: number;\n    securityReports?: {\n      keen?: { status: string; statusText: string; reportUrl?: string };\n      sanbu?: { status: string; statusText: string; reportUrl?: string };\n    };\n  };\n}\n"],"mappings":";;;AAYA,MAAM,qBAAqB;AAiD3B,SAAgB,0BAA0B,QAAwB;CAChE,MAAM,MAAM,QAAQ,IAAI,uBAAuB,MAAM;AACrD,KAAI,IACF,KAAI;AACF,SAAO,iBAAiB,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC;SAC1C;CAIV,MAAM,aAAa,OAAO,SAAS,oBAAoB,MAAM;AAC7D,KAAI,WACF,KAAI;AACF,SAAO,iBAAiB,IAAI,IAAI,WAAW,CAAC,UAAU,CAAC;SACjD;AACN,SAAO;;AAGX,QAAO;;;;;;AAST,SAAgB,8BAA8B,QAAwB;CACpE,MAAM,MAAM,QAAQ,IAAI,2BAA2B,MAAM;AACzD,KAAI,IACF,KAAI;AACF,SAAO,iBAAiB,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC;SAC1C;AAIV,QAAO,0BAA0B,OAAO;;AAG1C,SAAS,iBAAiB,KAAqB;AAC7C,QAAO,IAAI,QAAQ,OAAO,GAAG;;AAG/B,SAAgB,eAAe,SAAyB;CACtD,MAAM,IAAI,IAAI,IAAI,QAAQ;AAC1B,QAAO,GAAG,EAAE,SAAS,IAAI,EAAE;;;;;;AAO7B,SAAgB,yBAAyB,aAAqB,cAA2B;CACvF,IAAI;AACJ,KAAI;AACF,MAAI,IAAI,IAAI,YAAY;SAClB;AACN,QAAM,IAAI,MAAM,kCAAkC;;CAEpD,MAAM,UAAU,IAAI,IAAI,aAAa;AAIrC,KAFE,QAAQ,aAAa,YACpB,QAAQ,aAAa,eAAe,QAAQ,aAAa;MAEtD,EAAE,aAAa,WAAW,EAAE,aAAa,SAC3C,OAAM,IAAI,MAAM,sCAAsC;YAE/C,EAAE,aAAa,SACxB,OAAM,IAAI,MAAM,8BAA8B;AAEhD,KAAI,EAAE,SAAS,QAAQ,KACrB,OAAM,IAAI,MAAM,yDAAyD;AAE3E,QAAO;;AAGT,eAAe,UAAa,KAAa,MAAgC;CACvE,MAAM,MAAM,MAAM,MAAM,KAAK;EAC3B,GAAG;EACH,SAAS;GAAE,QAAQ;GAAoB,GAAG,MAAM;GAAS;EAC1D,CAAC;CACF,MAAM,OAAO,MAAM,IAAI,MAAM;AAC7B,KAAI,CAAC,IAAI,IAAI;EACX,IAAI,MAAM,yBAAyB,IAAI,OAAO;AAC9C,MAAI;GACF,MAAM,IAAI,KAAK,MAAM,KAAK;AAC1B,OAAI,EAAE,OAAO,QAAS,OAAM,EAAE,MAAM;UAC9B;AACN,OAAI,KAAM,OAAM,KAAK,MAAM,GAAG,IAAI;;AAEpC,QAAM,IAAI,MAAM,IAAI;;AAEtB,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;AACN,QAAM,IAAI,MAAM,8BAA8B;;;AAIlD,eAAsB,kBACpB,cACA,QACkC;CAClC,MAAM,OAAO,iBAAiB,aAAa;CAC3C,MAAM,KAAK,IAAI,iBAAiB;AAChC,IAAG,IAAI,QAAQ,QAAQ;AACvB,KAAI,OAAO,GAAG,MAAM,CAAE,IAAG,IAAI,KAAK,OAAO,EAAE,MAAM,CAAC;AAClD,KAAI,OAAO,QAAQ,KAAM,IAAG,IAAI,QAAQ,OAAO,OAAO,KAAK,CAAC;AAC5D,KAAI,OAAO,YAAY,KAAM,IAAG,IAAI,YAAY,OAAO,OAAO,SAAS,CAAC;AACxE,KAAI,OAAO,KAAM,IAAG,IAAI,QAAQ,OAAO,KAAK;AAC5C,KAAI,OAAO,UAAU,MAAM,CAAE,IAAG,IAAI,YAAY,OAAO,SAAS,MAAM,CAAC;AAGvE,QAAO,UAAmC,GAD3B,KAAK,mBAAmB,GAAG,UAAU,GACN;;AAmBhD,eAAsB,8BACpB,cACA,aACmC;AAGnC,QAAO,UAAoC,GAF9B,iBAAiB,aAEoB,CAAC,mBADvC,mBAAmB,YAAY,MAAM,CACwB,GAAG;;AAG9E,eAAsB,2BACpB,cACA,aACA,SACmD;CACnD,MAAM,OAAO,iBAAiB,aAAa;CAC3C,MAAM,MAAM,mBAAmB,YAAY;AAC3C,KAAI,SAAS,MAAM,EAAE;EAEnB,MAAM,SAAS,MAAM,UAGlB,GAAG,KAAK,mBAAmB,IAAI,YAJxB,mBAAmB,QAAQ,MAAM,CAII,GAAG;AAClD,MAAI,CAAC,OAAO,YACV,OAAM,IAAI,MAAM,oCAAoC;AAEtD,2BAAyB,OAAO,aAAa,KAAK;AAClD,SAAO;GAAE,aAAa,OAAO;GAAa,SAAS,OAAO;GAAS;;CAGrE,MAAM,MAAM,MAAM,UAGf,GAAG,KAAK,mBAAmB,MAAM;AACpC,KAAI,CAAC,IAAI,eAAe,YACtB,OAAM,IAAI,MAAM,mCAAmC;AAErD,0BAAyB,IAAI,cAAc,aAAa,KAAK;AAC7D,QAAO;EACL,aAAa,IAAI,cAAc;EAC/B,SAAS,IAAI,cAAc;EAC5B;;AAGH,eAAsB,uBACpB,cACA,aACiB;AAEjB,0BAAyB,aADZ,iBAAiB,aACY,CAAC;CAE3C,MAAM,MAAM,MAAM,MAAM,aAAa,EAAE,UAAU,UAAU,CAAC;AAC5D,KAAI,CAAC,IAAI,GACP,OAAM,IAAI,MAAM,qCAAqC,IAAI,OAAO,GAAG;CAErE,MAAM,MAAM,IAAI,QAAQ,IAAI,iBAAiB;AAC7C,KAAI,KAAK;EACP,MAAM,IAAI,OAAO,IAAI;AACrB,MAAI,OAAO,SAAS,EAAE,IAAI,IAAA,SACxB,OAAM,IAAI,MAAM,6BAA6B,oBAAoB,SAAS;;CAG9E,MAAM,KAAK,MAAM,IAAI,aAAa;CAClC,MAAM,MAAM,OAAO,KAAK,GAAG;AAC3B,KAAI,IAAI,SAAA,SACN,OAAM,IAAI,MAAM,6BAA6B,oBAAoB,SAAS;AAE5E,QAAO;;AAaT,eAAsB,+BACpB,cACA,aACA,SACmD;CACnD,MAAM,OAAO,iBAAiB,aAAa;CAC3C,MAAM,MAAM,mBAAmB,YAAY,MAAM,CAAC;CAClD,MAAM,OAAO,MAAM,UAAqC,GAAG,KAAK,mBAAmB,MAAM;AACzF,KAAI,KAAK,SAAS,YAChB,OAAM,IAAI,MACR,YAAY,YAAY,cAAc,KAAK,KAAK,iEAEjD;AAEH,KAAI,SAAS,MAAM,EAAE;EAEnB,MAAM,SAAS,MAAM,UACnB,GAAG,KAAK,mBAAmB,IAAI,YAFvB,mBAAmB,QAAQ,MAAM,CAEG,GAC7C;AACD,MAAI,CAAC,OAAO,YACV,OAAM,IAAI,MAAM,oCAAoC;AAEtD,2BAAyB,OAAO,aAAa,KAAK;AAClD,SAAO;GAAE,aAAa,OAAO;GAAa,SAAS,OAAO;GAAS;;CAErE,MAAM,KAAK,KAAK;AAChB,KAAI,CAAC,IAAI,YACP,OAAM,IAAI,MAAM,mCAAmC;AAErD,0BAAyB,GAAG,aAAa,KAAK;AAC9C,QAAO;EAAE,aAAa,GAAG;EAAa,SAAS,GAAG;EAAS;;AAG7D,eAAsB,gCACpB,cACA,aACiB;AAEjB,0BAAyB,aADZ,iBAAiB,aACY,CAAC;CAC3C,MAAM,MAAM,MAAM,MAAM,aAAa,EAAE,UAAU,UAAU,CAAC;AAC5D,KAAI,CAAC,IAAI,GACP,OAAM,IAAI,MAAM,yCAAyC,IAAI,OAAO,GAAG;CAEzE,MAAM,MAAM,IAAI,QAAQ,IAAI,iBAAiB;AAC7C,KAAI,KAAK;EACP,MAAM,IAAI,OAAO,IAAI;AACrB,MAAI,OAAO,SAAS,EAAE,IAAI,IAAA,SACxB,OAAM,IAAI,MAAM,6BAA6B,8BAA8B,SAAS;;CAGxF,MAAM,KAAK,MAAM,IAAI,aAAa;CAClC,MAAM,MAAM,OAAO,KAAK,GAAG;AAC3B,KAAI,IAAI,SAAA,SACN,OAAM,IAAI,MAAM,6BAA6B,8BAA8B,SAAS;AAEtF,QAAO;;AAGT,SAAgB,6BAA6B,aAAyC;CACpF,MAAM,UAAU,YAAY,MAAM;AAClC,KAAI,CAAC,QAAS,QAAO,KAAA;AACrB,QAAO,eAAe,QAAQ,GAAG,UAAU,KAAA"}

package/dist/src/agent/skills/skill-manager.d.ts

@@ -79,7 +79,10 @@ export declare class SkillManager {
     /**
      * Expand a skill command into a full skill block
      */
-    expandCommand(text: string): string;
+    expandCommand(text: string, options?: {
+        skillAllowlist?: string[];
+        registeredToolNames?: string[];
+    }): string;
     /**
      * Parse a /skill: command
      */

package/dist/src/agent/skills/skill-manager.js

@@ -147,12 +147,12 @@ var SkillManager = class {
 	/**
 	* Expand a skill command into a full skill block
 	*/
-	expandCommand(text) {
+	expandCommand(text, options) {
 		if (!text.startsWith("/skill:")) return text;
 		const { skillName, args } = this.parseSkillCommand(text);
-		const skill = this.findSkill(skillName);
+		const skill = this.selectSkillsForAgentIndexing(options).find((s) => s.name === skillName);
 		if (!skill) {
-			log.warn({ skillName }, "Skill not found for expansion");
+			log.warn({ skillName }, "Skill not visible for expansion");
 			return text;
 		}
 		return this.buildSkillBlock(skill, args);

package/dist/src/agent/skills/skill-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manager.js","names":[],"sources":["../../../../src/agent/skills/skill-manager.ts"],"sourcesContent":["/**\n * Skill Manager - Manages skills loading and expansion\n *\n * Handles skill initialization, reloading, and command expansion.\n */\n\nimport { createSkillLoader, type Skill } from './index.js';\nimport { resolveBundledSkillsDir, resolveStateDir } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { createSkillConfigManager, isSkillEnabled } from './config.js';\nimport { formatSkillsForPrompt, selectSkillsVisibleInPrompt } from './format-skills-prompt.js';\n\nconst log = createLogger('SkillManager');\n\nexport interface SkillDiagnostic {\n  type: 'collision' | 'warning' | 'error' | 'info';\n  skillName: string;\n  message: string;\n}\n\nexport interface SkillLoadResult {\n  skills: Skill[];\n  prompt: string;\n  diagnostics: SkillDiagnostic[];\n}\n\nexport class SkillManager {\n  private skillPrompt: string = '';\n  private skills: Skill[] = [];\n  private skillLoader = createSkillLoader();\n  private workspace: string;\n  private bundledSkillsDir: string;\n\n  constructor(workspace: string, bundledSkillsDir?: string) {\n    this.workspace = workspace;\n    this.bundledSkillsDir = bundledSkillsDir || resolveBundledSkillsDir();\n    this.initialize();\n  }\n\n  /**\n   * Initialize skills from workspace and bundled directories\n   */\n  private initialize(): void {\n    const result = this.skillLoader.init(this.workspace, this.bundledSkillsDir);\n    this.skillPrompt = result.prompt;\n    this.skills = result.skills;\n\n    // Log diagnostics\n    for (const diag of result.diagnostics) {\n      if (diag.type === 'collision') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill collision');\n      } else if (diag.type === 'warning') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill warning');\n      } else if (diag.type === 'error') {\n        log.error({ skill: diag.skillName, message: diag.message }, 'Skill error');\n      } else {\n        log.info({ skill: diag.skillName, message: diag.message }, 'Skill info');\n      }\n    }\n\n    log.debug({ count: result.skills.length }, 'Skills loaded');\n  }\n\n  /**\n   * Recompute skill XML prompt from current skills.json (no disk rescan).\n   */\n  refreshPromptFromConfig(): void {\n    this.skillLoader.refreshPromptFromConfig();\n    this.skillPrompt = this.skillLoader.getPrompt();\n  }\n\n  /**\n   * Reload skills from disk\n   */\n  reload(): void {\n    log.info('Reloading skills...');\n    const result = this.skillLoader.reload();\n    this.skillPrompt = result.prompt;\n    this.skills = result.skills;\n\n    for (const diag of result.diagnostics) {\n      if (diag.type === 'collision') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill collision');\n      } else if (diag.type === 'warning') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill warning');\n      } else if (diag.type === 'error') {\n        log.error({ skill: diag.skillName, message: diag.message }, 'Skill error');\n      }\n    }\n\n    log.info({ count: result.skills.length }, 'Skills reloaded');\n  }\n\n  /**\n   * Get the skill prompt to append to system prompt\n   */\n  getPrompt(): string {\n    return this.skillPrompt;\n  }\n\n  /**\n   * `<available_skills>` XML with optional per-agent allowlist and/or tool-based gating.\n   * When both arguments are omitted, returns the cached prompt from disk load (no tool gating).\n   */\n  getPromptForSkillAllowlist(\n    allowlist: string[] | undefined,\n    registeredToolNames?: string[],\n  ): string {\n    if (allowlist === undefined && registeredToolNames === undefined) {\n      return this.getPrompt();\n    }\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return formatSkillsForPrompt(this.getSkills(), skillsConfig, {\n      skillAllowlist: allowlist,\n      registeredToolNames,\n    });\n  }\n\n  /** Skills visible for prompts and skills_list given the same indexing options as {@link getPromptForSkillAllowlist}. */\n  selectSkillsForAgentIndexing(options?: {\n    skillAllowlist?: string[];\n    registeredToolNames?: string[];\n  }): Skill[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return selectSkillsVisibleInPrompt(this.getSkills(), skillsConfig, options);\n  }\n\n  /**\n   * Get all loaded skills\n   */\n  getSkills(): Skill[] {\n    return [...this.skills];\n  }\n\n  /**\n   * Get skill names\n   */\n  getSkillNames(): string[] {\n    return this.skills.map((s) => s.name);\n  }\n\n  /** Names of skills included in the agent system prompt (`<available_skills>`). */\n  getSkillNamesForPrompt(): string[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return this.getSkills()\n      .filter((s) => !s.disableModelInvocation && isSkillEnabled(s, skillsConfig))\n      .map((s) => s.name);\n  }\n\n  /**\n   * Skills that are enabled for model discovery (respects skills.json and requirement checks).\n   */\n  getEnabledSkills(): Skill[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return this.getSkills().filter(\n      (s) => !s.disableModelInvocation && isSkillEnabled(s, skillsConfig),\n    );\n  }\n\n  /**\n   * Like {@link getEnabledSkills} plus optional allowlist and tool gating (matches `<available_skills>`).\n   */\n  getEnabledSkillsForAgentSession(options?: {\n    skillAllowlist?: string[];\n    registeredToolNames?: string[];\n  }): Skill[] {\n    return this.selectSkillsForAgentIndexing(options);\n  }\n\n  /**\n   * Find a skill by name\n   */\n  findSkill(name: string): Skill | undefined {\n    return this.skills.find(s => s.name === name);\n  }\n\n  /**\n   * Check if a skill exists\n   */\n  hasSkill(name: string): boolean {\n    return this.skills.some(s => s.name === name);\n  }\n\n  /**\n   * Expand a skill command into a full skill block\n   */\n  expandCommand(text: string): string {\n    if (!text.startsWith('/skill:')) {\n      return text;\n    }\n\n    const { skillName, args } = this.parseSkillCommand(text);\n    const skill = this.findSkill(skillName);\n\n    if (!skill) {\n      log.warn({ skillName }, 'Skill not found for expansion');\n      return text;\n    }\n\n    return this.buildSkillBlock(skill, args);\n  }\n\n  /**\n   * Parse a /skill: command\n   */\n  private parseSkillCommand(text: string): { skillName: string; args?: string } {\n    // Format: /skill:name args...\n    const withoutPrefix = text.slice(7); // Remove '/skill:'\n    const spaceIndex = withoutPrefix.indexOf(' ');\n\n    if (spaceIndex === -1) {\n      return { skillName: withoutPrefix.trim() };\n    }\n\n    return {\n      skillName: withoutPrefix.slice(0, spaceIndex).trim(),\n      args: withoutPrefix.slice(spaceIndex + 1).trim(),\n    };\n  }\n\n  /**\n   * Build a skill block for inclusion in the prompt\n   */\n  private buildSkillBlock(skill: Skill, args?: string): string {\n    let block = `\\n\\n## Skill: ${skill.name}\\n\\n`;\n    \n    if (skill.description) {\n      block += `${skill.description}\\n\\n`;\n    }\n\n    // Include raw skill content (SKILL.md content)\n    if (skill.content) {\n      block += `${skill.content}\\n\\n`;\n    }\n\n    if (args) {\n      block += `**Arguments**: ${args}\\n\\n`;\n    }\n\n    return block;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"skill-manager.js","names":[],"sources":["../../../../src/agent/skills/skill-manager.ts"],"sourcesContent":["/**\n * Skill Manager - Manages skills loading and expansion\n *\n * Handles skill initialization, reloading, and command expansion.\n */\n\nimport { createSkillLoader, type Skill } from './index.js';\nimport { resolveBundledSkillsDir, resolveStateDir } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { createSkillConfigManager, isSkillEnabled } from './config.js';\nimport { formatSkillsForPrompt, selectSkillsVisibleInPrompt } from './format-skills-prompt.js';\n\nconst log = createLogger('SkillManager');\n\nexport interface SkillDiagnostic {\n  type: 'collision' | 'warning' | 'error' | 'info';\n  skillName: string;\n  message: string;\n}\n\nexport interface SkillLoadResult {\n  skills: Skill[];\n  prompt: string;\n  diagnostics: SkillDiagnostic[];\n}\n\nexport class SkillManager {\n  private skillPrompt: string = '';\n  private skills: Skill[] = [];\n  private skillLoader = createSkillLoader();\n  private workspace: string;\n  private bundledSkillsDir: string;\n\n  constructor(workspace: string, bundledSkillsDir?: string) {\n    this.workspace = workspace;\n    this.bundledSkillsDir = bundledSkillsDir || resolveBundledSkillsDir();\n    this.initialize();\n  }\n\n  /**\n   * Initialize skills from workspace and bundled directories\n   */\n  private initialize(): void {\n    const result = this.skillLoader.init(this.workspace, this.bundledSkillsDir);\n    this.skillPrompt = result.prompt;\n    this.skills = result.skills;\n\n    // Log diagnostics\n    for (const diag of result.diagnostics) {\n      if (diag.type === 'collision') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill collision');\n      } else if (diag.type === 'warning') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill warning');\n      } else if (diag.type === 'error') {\n        log.error({ skill: diag.skillName, message: diag.message }, 'Skill error');\n      } else {\n        log.info({ skill: diag.skillName, message: diag.message }, 'Skill info');\n      }\n    }\n\n    log.debug({ count: result.skills.length }, 'Skills loaded');\n  }\n\n  /**\n   * Recompute skill XML prompt from current skills.json (no disk rescan).\n   */\n  refreshPromptFromConfig(): void {\n    this.skillLoader.refreshPromptFromConfig();\n    this.skillPrompt = this.skillLoader.getPrompt();\n  }\n\n  /**\n   * Reload skills from disk\n   */\n  reload(): void {\n    log.info('Reloading skills...');\n    const result = this.skillLoader.reload();\n    this.skillPrompt = result.prompt;\n    this.skills = result.skills;\n\n    for (const diag of result.diagnostics) {\n      if (diag.type === 'collision') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill collision');\n      } else if (diag.type === 'warning') {\n        log.warn({ skill: diag.skillName, message: diag.message }, 'Skill warning');\n      } else if (diag.type === 'error') {\n        log.error({ skill: diag.skillName, message: diag.message }, 'Skill error');\n      }\n    }\n\n    log.info({ count: result.skills.length }, 'Skills reloaded');\n  }\n\n  /**\n   * Get the skill prompt to append to system prompt\n   */\n  getPrompt(): string {\n    return this.skillPrompt;\n  }\n\n  /**\n   * `<available_skills>` XML with optional per-agent allowlist and/or tool-based gating.\n   * When both arguments are omitted, returns the cached prompt from disk load (no tool gating).\n   */\n  getPromptForSkillAllowlist(\n    allowlist: string[] | undefined,\n    registeredToolNames?: string[],\n  ): string {\n    if (allowlist === undefined && registeredToolNames === undefined) {\n      return this.getPrompt();\n    }\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return formatSkillsForPrompt(this.getSkills(), skillsConfig, {\n      skillAllowlist: allowlist,\n      registeredToolNames,\n    });\n  }\n\n  /** Skills visible for prompts and skills_list given the same indexing options as {@link getPromptForSkillAllowlist}. */\n  selectSkillsForAgentIndexing(options?: {\n    skillAllowlist?: string[];\n    registeredToolNames?: string[];\n  }): Skill[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return selectSkillsVisibleInPrompt(this.getSkills(), skillsConfig, options);\n  }\n\n  /**\n   * Get all loaded skills\n   */\n  getSkills(): Skill[] {\n    return [...this.skills];\n  }\n\n  /**\n   * Get skill names\n   */\n  getSkillNames(): string[] {\n    return this.skills.map((s) => s.name);\n  }\n\n  /** Names of skills included in the agent system prompt (`<available_skills>`). */\n  getSkillNamesForPrompt(): string[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return this.getSkills()\n      .filter((s) => !s.disableModelInvocation && isSkillEnabled(s, skillsConfig))\n      .map((s) => s.name);\n  }\n\n  /**\n   * Skills that are enabled for model discovery (respects skills.json and requirement checks).\n   */\n  getEnabledSkills(): Skill[] {\n    const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n    return this.getSkills().filter(\n      (s) => !s.disableModelInvocation && isSkillEnabled(s, skillsConfig),\n    );\n  }\n\n  /**\n   * Like {@link getEnabledSkills} plus optional allowlist and tool gating (matches `<available_skills>`).\n   */\n  getEnabledSkillsForAgentSession(options?: {\n    skillAllowlist?: string[];\n    registeredToolNames?: string[];\n  }): Skill[] {\n    return this.selectSkillsForAgentIndexing(options);\n  }\n\n  /**\n   * Find a skill by name\n   */\n  findSkill(name: string): Skill | undefined {\n    return this.skills.find(s => s.name === name);\n  }\n\n  /**\n   * Check if a skill exists\n   */\n  hasSkill(name: string): boolean {\n    return this.skills.some(s => s.name === name);\n  }\n\n  /**\n   * Expand a skill command into a full skill block\n   */\n  expandCommand(text: string, options?: { skillAllowlist?: string[]; registeredToolNames?: string[] }): string {\n    if (!text.startsWith('/skill:')) {\n      return text;\n    }\n\n    const { skillName, args } = this.parseSkillCommand(text);\n    const visible = this.selectSkillsForAgentIndexing(options);\n    const skill = visible.find((s) => s.name === skillName);\n\n    if (!skill) {\n      log.warn({ skillName }, 'Skill not visible for expansion');\n      return text;\n    }\n\n    return this.buildSkillBlock(skill, args);\n  }\n\n  /**\n   * Parse a /skill: command\n   */\n  private parseSkillCommand(text: string): { skillName: string; args?: string } {\n    // Format: /skill:name args...\n    const withoutPrefix = text.slice(7); // Remove '/skill:'\n    const spaceIndex = withoutPrefix.indexOf(' ');\n\n    if (spaceIndex === -1) {\n      return { skillName: withoutPrefix.trim() };\n    }\n\n    return {\n      skillName: withoutPrefix.slice(0, spaceIndex).trim(),\n      args: withoutPrefix.slice(spaceIndex + 1).trim(),\n    };\n  }\n\n  /**\n   * Build a skill block for inclusion in the prompt\n   */\n  private buildSkillBlock(skill: Skill, args?: string): string {\n    let block = `\\n\\n## Skill: ${skill.name}\\n\\n`;\n    \n    if (skill.description) {\n      block += `${skill.description}\\n\\n`;\n    }\n\n    // Include raw skill content (SKILL.md content)\n    if (skill.content) {\n      block += `${skill.content}\\n\\n`;\n    }\n\n    if (args) {\n      block += `**Arguments**: ${args}\\n\\n`;\n    }\n\n    return block;\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/skills/skill-view-path.d.ts

@@ -1,8 +1,7 @@
 /**
  * Resolve safe paths for skill_view: only SKILL.md (default) or files under allowlisted subdirs.
- * Also provides localized SKILL.md resolution for multi-language display.
  */
-import type { Skill, SkillMarkdownPreviewPayload } from './types.js';
+import type { Skill } from './types.js';
 export type ResolveSkillFileResult = {
     ok: true;
     absolutePath: string;
@@ -15,18 +14,3 @@ export type ResolveSkillFileResult = {
  * Other paths must live under references/, templates/, scripts/, or assets/.
  */
 export declare function resolveSkillReadablePath(skill: Skill, subPath: string | undefined): ResolveSkillFileResult;
-/**
- * Resolve a localized SKILL.md for display (e.g. SKILL-zh.md, SKILL-en.md).
- * Falls back to the base SKILL.md content if no localized file exists.
- *
- * This is the **display** path — execution always reads the base SKILL.md.
- */
-export declare function resolveLocalizedSkillMarkdown(skill: Skill, lang?: string): SkillMarkdownPreviewPayload | null;
-/**
- * Lightweight localized name/description lookup (frontmatter only) for list views.
- * Reuses the same SKILL-{lang}.md resolution as {@link resolveLocalizedSkillMarkdown}.
- */
-export declare function resolveLocalizedSkillMeta(skill: Skill, lang: string): {
-    name: string;
-    description: string;
-} | null;

package/dist/src/agent/skills/skill-view-path.js

@@ -1,13 +1,8 @@
-import { parseFrontmatter } from "../../markdown/frontmatter.js";
-import { parseSkillToolConditions } from "./skill-tool-gating.js";
-import { parseRequiredEnvVarNames } from "./required-env-vars.js";
-import { parseSkillMetadata } from "./parse-skill-metadata.js";
-import { join, resolve, sep } from "path";
-import { existsSync, readFileSync, realpathSync } from "fs";
+import { resolve, sep } from "path";
+import { existsSync, realpathSync } from "fs";
 //#region src/agent/skills/skill-view-path.ts
 /**
 * Resolve safe paths for skill_view: only SKILL.md (default) or files under allowlisted subdirs.
-* Also provides localized SKILL.md resolution for multi-language display.
 */
 const ALLOWED_TOP = new Set([
 	"references",
@@ -71,65 +66,7 @@ function resolveSkillReadablePath(skill, subPath) {
 		};
 	}
 }
-/**
-* Resolve a localized SKILL.md for display (e.g. SKILL-zh.md, SKILL-en.md).
-* Falls back to the base SKILL.md content if no localized file exists.
-*
-* This is the **display** path — execution always reads the base SKILL.md.
-*/
-function resolveLocalizedSkillMarkdown(skill, lang) {
-	if (!lang) return null;
-	const normalizedLang = lang.split(/[-_]/)[0]?.toLowerCase();
-	if (!normalizedLang || normalizedLang === "en") return null;
-	const localizedPath = join(skill.baseDir, `SKILL-${normalizedLang}.md`);
-	if (!existsSync(localizedPath)) return null;
-	try {
-		const { frontmatter, content } = parseFrontmatter(readFileSync(localizedPath, "utf-8"));
-		const fm = frontmatter;
-		const name = typeof fm.name === "string" && fm.name.trim() || skill.name;
-		const description = (typeof fm.description === "string" ? fm.description.trim() : "") || skill.description;
-		const metadata = parseSkillMetadata(fm);
-		if (!metadata.name.trim()) metadata.name = name;
-		if (!metadata.description.trim()) metadata.description = description;
-		const toolConditions = parseSkillToolConditions(fm);
-		const requiredEnvVarNames = parseRequiredEnvVarNames(fm);
-		return {
-			name,
-			description,
-			bodyMarkdown: content.trim(),
-			disableModelInvocation: skill.disableModelInvocation,
-			metadata,
-			toolConditions,
-			requiredEnvVarNames: requiredEnvVarNames.length > 0 ? requiredEnvVarNames : void 0
-		};
-	} catch {
-		return null;
-	}
-}
-/**
-* Lightweight localized name/description lookup (frontmatter only) for list views.
-* Reuses the same SKILL-{lang}.md resolution as {@link resolveLocalizedSkillMarkdown}.
-*/
-function resolveLocalizedSkillMeta(skill, lang) {
-	const normalizedLang = lang.split(/[-_]/)[0]?.toLowerCase();
-	if (!normalizedLang || normalizedLang === "en") return null;
-	const localizedPath = join(skill.baseDir, `SKILL-${normalizedLang}.md`);
-	if (!existsSync(localizedPath)) return null;
-	try {
-		const { frontmatter } = parseFrontmatter(readFileSync(localizedPath, "utf-8"));
-		const fm = frontmatter;
-		const name = typeof fm.name === "string" && fm.name.trim() ? fm.name.trim() : void 0;
-		const description = typeof fm.description === "string" && fm.description.trim() ? fm.description.trim() : void 0;
-		if (!name && !description) return null;
-		return {
-			name: name ?? skill.name,
-			description: description ?? skill.description
-		};
-	} catch {
-		return null;
-	}
-}
 //#endregion
-export { resolveLocalizedSkillMarkdown, resolveLocalizedSkillMeta, resolveSkillReadablePath };
+export { resolveSkillReadablePath };
 
 //# sourceMappingURL=skill-view-path.js.map

package/dist/src/agent/skills/skill-view-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-view-path.js","names":[],"sources":["../../../../src/agent/skills/skill-view-path.ts"],"sourcesContent":["/**\n * Resolve safe paths for skill_view: only SKILL.md (default) or files under allowlisted subdirs.\n * Also provides localized SKILL.md resolution for multi-language display.\n */\n\nimport { existsSync, readFileSync, realpathSync } from 'fs';\nimport { join, resolve, sep } from 'path';\n\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { parseRequiredEnvVarNames } from './required-env-vars.js';\nimport { parseSkillMetadata } from './parse-skill-metadata.js';\nimport { parseSkillToolConditions } from './skill-tool-gating.js';\nimport type { Skill, SkillMarkdownPreviewPayload } from './types.js';\n\nconst ALLOWED_TOP = new Set(['references', 'templates', 'scripts', 'assets']);\n\nexport type ResolveSkillFileResult =\n  | { ok: true; absolutePath: string }\n  | { ok: false; error: string };\n\nfunction isSkillMdSegment(p: string): boolean {\n  const s = p.trim();\n  return s === 'SKILL.md' || s.toLowerCase() === 'skill.md';\n}\n\nfunction isInsideDir(dirReal: string, fileReal: string): boolean {\n  const prefix = dirReal.endsWith(sep) ? dirReal : dirReal + sep;\n  return fileReal === dirReal || fileReal.startsWith(prefix);\n}\n\n/**\n * Resolve a readable file path for {@link skill}. Empty or SKILL.md → main SKILL.md file.\n * Other paths must live under references/, templates/, scripts/, or assets/.\n */\nexport function resolveSkillReadablePath(\n  skill: Skill,\n  subPath: string | undefined,\n): ResolveSkillFileResult {\n  const base = skill.baseDir;\n  const trimmed = subPath?.trim() ?? '';\n\n  let target: string;\n  if (!trimmed || trimmed === '.' || isSkillMdSegment(trimmed)) {\n    target = skill.filePath;\n  } else {\n    const norm = trimmed.replace(/\\\\/g, '/');\n    if (norm.includes('..')) {\n      return { ok: false, error: 'Invalid path: path traversal is not allowed.' };\n    }\n    if (norm.startsWith('/') || /^[A-Za-z]:/.test(norm)) {\n      return {\n        ok: false,\n        error: 'Invalid path: use a path relative to the skill directory.',\n      };\n    }\n    const first = norm.split('/').filter(Boolean)[0] ?? '';\n    if (!ALLOWED_TOP.has(first)) {\n      return {\n        ok: false,\n        error: `Invalid path: must be under references/, templates/, scripts/, or assets/ (or omit path for SKILL.md).`,\n      };\n    }\n    target = resolve(base, norm);\n  }\n\n  try {\n    const baseReal = realpathSync(base);\n    if (!existsSync(target)) {\n      return { ok: false, error: `File not found: ${trimmed || 'SKILL.md'}` };\n    }\n    const targetReal = realpathSync(target);\n    if (!isInsideDir(baseReal, targetReal)) {\n      return { ok: false, error: 'Resolved path escapes the skill directory.' };\n    }\n    return { ok: true, absolutePath: targetReal };\n  } catch (e) {\n    return { ok: false, error: e instanceof Error ? e.message : String(e) };\n  }\n}\n\n/**\n * Resolve a localized SKILL.md for display (e.g. SKILL-zh.md, SKILL-en.md).\n * Falls back to the base SKILL.md content if no localized file exists.\n *\n * This is the **display** path — execution always reads the base SKILL.md.\n */\nexport function resolveLocalizedSkillMarkdown(\n  skill: Skill,\n  lang?: string,\n): SkillMarkdownPreviewPayload | null {\n  if (!lang) {\n    return null; // caller should fall back to skill.content\n  }\n\n  // Normalize: prefer two-letter code\n  const normalizedLang = lang.split(/[-_]/)[0]?.toLowerCase();\n  if (!normalizedLang || normalizedLang === 'en') {\n    return null; // 'en' is the base SKILL.md\n  }\n\n  const localizedPath = join(skill.baseDir, `SKILL-${normalizedLang}.md`);\n  if (!existsSync(localizedPath)) {\n    return null;\n  }\n\n  try {\n    const rawContent = readFileSync(localizedPath, 'utf-8');\n    const { frontmatter, content } = parseFrontmatter(rawContent);\n    const fm = frontmatter as Record<string, unknown>;\n\n    const name = (typeof fm.name === 'string' && fm.name.trim()) || skill.name;\n    const descFromFm = typeof fm.description === 'string' ? fm.description.trim() : '';\n    const description = descFromFm || skill.description;\n    const metadata = parseSkillMetadata(fm);\n    if (!metadata.name.trim()) metadata.name = name;\n    if (!metadata.description.trim()) metadata.description = description;\n\n    const toolConditions = parseSkillToolConditions(fm);\n    const requiredEnvVarNames = parseRequiredEnvVarNames(fm);\n\n    return {\n      name,\n      description,\n      bodyMarkdown: content.trim(),\n      disableModelInvocation: skill.disableModelInvocation,\n      metadata,\n      toolConditions,\n      requiredEnvVarNames: requiredEnvVarNames.length > 0 ? requiredEnvVarNames : undefined,\n    };\n  } catch {\n    return null; // parse error → fall back\n  }\n}\n\n/**\n * Lightweight localized name/description lookup (frontmatter only) for list views.\n * Reuses the same SKILL-{lang}.md resolution as {@link resolveLocalizedSkillMarkdown}.\n */\nexport function resolveLocalizedSkillMeta(\n  skill: Skill,\n  lang: string,\n): { name: string; description: string } | null {\n  const normalizedLang = lang.split(/[-_]/)[0]?.toLowerCase();\n  if (!normalizedLang || normalizedLang === 'en') return null;\n\n  const localizedPath = join(skill.baseDir, `SKILL-${normalizedLang}.md`);\n  if (!existsSync(localizedPath)) return null;\n\n  try {\n    const rawContent = readFileSync(localizedPath, 'utf-8');\n    const { frontmatter } = parseFrontmatter(rawContent);\n    const fm = frontmatter as Record<string, unknown>;\n    const name = typeof fm.name === 'string' && fm.name.trim() ? fm.name.trim() : undefined;\n    const description =\n      typeof fm.description === 'string' && fm.description.trim() ? fm.description.trim() : undefined;\n    if (!name && !description) return null;\n    return {\n      name: name ?? skill.name,\n      description: description ?? skill.description,\n    };\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"skill-view-path.js","names":[],"sources":["../../../../src/agent/skills/skill-view-path.ts"],"sourcesContent":["/**\n * Resolve safe paths for skill_view: only SKILL.md (default) or files under allowlisted subdirs.\n */\n\nimport { existsSync, realpathSync } from 'fs';\nimport { resolve, sep } from 'path';\n\nimport type { Skill } from './types.js';\n\nconst ALLOWED_TOP = new Set(['references', 'templates', 'scripts', 'assets']);\n\nexport type ResolveSkillFileResult =\n  | { ok: true; absolutePath: string }\n  | { ok: false; error: string };\n\nfunction isSkillMdSegment(p: string): boolean {\n  const s = p.trim();\n  return s === 'SKILL.md' || s.toLowerCase() === 'skill.md';\n}\n\nfunction isInsideDir(dirReal: string, fileReal: string): boolean {\n  const prefix = dirReal.endsWith(sep) ? dirReal : dirReal + sep;\n  return fileReal === dirReal || fileReal.startsWith(prefix);\n}\n\n/**\n * Resolve a readable file path for {@link skill}. Empty or SKILL.md → main SKILL.md file.\n * Other paths must live under references/, templates/, scripts/, or assets/.\n */\nexport function resolveSkillReadablePath(\n  skill: Skill,\n  subPath: string | undefined,\n): ResolveSkillFileResult {\n  const base = skill.baseDir;\n  const trimmed = subPath?.trim() ?? '';\n\n  let target: string;\n  if (!trimmed || trimmed === '.' || isSkillMdSegment(trimmed)) {\n    target = skill.filePath;\n  } else {\n    const norm = trimmed.replace(/\\\\/g, '/');\n    if (norm.includes('..')) {\n      return { ok: false, error: 'Invalid path: path traversal is not allowed.' };\n    }\n    if (norm.startsWith('/') || /^[A-Za-z]:/.test(norm)) {\n      return {\n        ok: false,\n        error: 'Invalid path: use a path relative to the skill directory.',\n      };\n    }\n    const first = norm.split('/').filter(Boolean)[0] ?? '';\n    if (!ALLOWED_TOP.has(first)) {\n      return {\n        ok: false,\n        error: `Invalid path: must be under references/, templates/, scripts/, or assets/ (or omit path for SKILL.md).`,\n      };\n    }\n    target = resolve(base, norm);\n  }\n\n  try {\n    const baseReal = realpathSync(base);\n    if (!existsSync(target)) {\n      return { ok: false, error: `File not found: ${trimmed || 'SKILL.md'}` };\n    }\n    const targetReal = realpathSync(target);\n    if (!isInsideDir(baseReal, targetReal)) {\n      return { ok: false, error: 'Resolved path escapes the skill directory.' };\n    }\n    return { ok: true, absolutePath: targetReal };\n  } catch (e) {\n    return { ok: false, error: e instanceof Error ? e.message : String(e) };\n  }\n}\n"],"mappings":";;;;;;AASA,MAAM,cAAc,IAAI,IAAI;CAAC;CAAc;CAAa;CAAW;CAAS,CAAC;AAM7E,SAAS,iBAAiB,GAAoB;CAC5C,MAAM,IAAI,EAAE,MAAM;AAClB,QAAO,MAAM,cAAc,EAAE,aAAa,KAAK;;AAGjD,SAAS,YAAY,SAAiB,UAA2B;CAC/D,MAAM,SAAS,QAAQ,SAAS,IAAI,GAAG,UAAU,UAAU;AAC3D,QAAO,aAAa,WAAW,SAAS,WAAW,OAAO;;;;;;AAO5D,SAAgB,yBACd,OACA,SACwB;CACxB,MAAM,OAAO,MAAM;CACnB,MAAM,UAAU,SAAS,MAAM,IAAI;CAEnC,IAAI;AACJ,KAAI,CAAC,WAAW,YAAY,OAAO,iBAAiB,QAAQ,CAC1D,UAAS,MAAM;MACV;EACL,MAAM,OAAO,QAAQ,QAAQ,OAAO,IAAI;AACxC,MAAI,KAAK,SAAS,KAAK,CACrB,QAAO;GAAE,IAAI;GAAO,OAAO;GAAgD;AAE7E,MAAI,KAAK,WAAW,IAAI,IAAI,aAAa,KAAK,KAAK,CACjD,QAAO;GACL,IAAI;GACJ,OAAO;GACR;EAEH,MAAM,QAAQ,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC,MAAM;AACpD,MAAI,CAAC,YAAY,IAAI,MAAM,CACzB,QAAO;GACL,IAAI;GACJ,OAAO;GACR;AAEH,WAAS,QAAQ,MAAM,KAAK;;AAG9B,KAAI;EACF,MAAM,WAAW,aAAa,KAAK;AACnC,MAAI,CAAC,WAAW,OAAO,CACrB,QAAO;GAAE,IAAI;GAAO,OAAO,mBAAmB,WAAW;GAAc;EAEzE,MAAM,aAAa,aAAa,OAAO;AACvC,MAAI,CAAC,YAAY,UAAU,WAAW,CACpC,QAAO;GAAE,IAAI;GAAO,OAAO;GAA8C;AAE3E,SAAO;GAAE,IAAI;GAAM,cAAc;GAAY;UACtC,GAAG;AACV,SAAO;GAAE,IAAI;GAAO,OAAO,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;GAAE"}

package/dist/src/agent/skills/test-framework.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
-import { hasBinary, init_installer } from "./installer.js";
-import { parseSkillMetadata } from "./parse-skill-metadata.js";
+import { hasBinary } from "./installer.js";
 import { scanSkillDirectory } from "./scanner.js";
+import { parseSkillMetadata } from "./parse-skill-metadata.js";
 import { basename, join, relative } from "path";
 import { existsSync, readFileSync, readdirSync } from "fs";
 //#region src/agent/skills/test-framework.ts
@@ -14,7 +14,6 @@ import { existsSync, readFileSync, readdirSync } from "fs";
 * Validates SKILL.md format, dependencies, security, and examples.
 */
 init_logger();
-init_installer();
 const log = createLogger("SkillTestFramework");
 var SkillTestFramework = class {
 	options;

package/dist/src/agent/skills/test-framework.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-framework.js","names":[],"sources":["../../../../src/agent/skills/test-framework.ts"],"sourcesContent":["/**\n * Skill Test Framework\n * \n * Comprehensive testing framework for skills.\n * Validates SKILL.md format, dependencies, security, and examples.\n */\n\nimport { existsSync, readFileSync, readdirSync } from 'fs';\nimport { basename, join, relative } from 'path';\nimport { createLogger } from '../../utils/logger.js';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { parseSkillMetadata } from './parse-skill-metadata.js';\nimport { scanSkillDirectory } from './scanner.js';\nimport { hasBinary } from './installer.js';\nimport type { SkillMetadata, SkillInstallSpec } from './types.js';\n\nconst log = createLogger('SkillTestFramework');\n\n// ============================================================================\n// Test Result Types\n// ============================================================================\n\nexport type TestStatus = 'pass' | 'fail' | 'warn' | 'skip';\n\nexport interface TestResult {\n  name: string;\n  status: TestStatus;\n  message?: string;\n  details?: string[];\n  duration?: number;\n}\n\nexport interface SkillTestReport {\n  skillName: string;\n  skillPath: string;\n  timestamp: number;\n  results: TestResult[];\n  summary: {\n    total: number;\n    passed: number;\n    failed: number;\n    warnings: number;\n    skipped: number;\n  };\n  passed: boolean;\n}\n\nexport interface TestOptions {\n  /** Skip security tests */\n  skipSecurity?: boolean;\n  /** Skip dependency tests */\n  skipDeps?: boolean;\n  /** Skip example tests */\n  skipExamples?: boolean;\n  /** Strict mode - fail on warnings */\n  strict?: boolean;\n  /** Timeout for example tests (ms) */\n  exampleTimeout?: number;\n  /** Working directory for example tests */\n  cwd?: string;\n}\n\n// ============================================================================\n// Test Framework Core\n// ============================================================================\n\nexport class SkillTestFramework {\n  private options: TestOptions;\n\n  constructor(options: TestOptions = {}) {\n    this.options = {\n      skipSecurity: false,\n      skipDeps: false,\n      skipExamples: false,\n      strict: false,\n      exampleTimeout: 10000,\n      cwd: process.cwd(),\n      ...options,\n    };\n  }\n\n  /**\n   * Run all tests for a skill\n   */\n  async testSkill(skillDir: string): Promise<SkillTestReport> {\n    const results: TestResult[] = [];\n\n    log.info({ skillDir }, 'Testing skill');\n\n    // Validate skill directory\n    if (!existsSync(skillDir)) {\n      return this.createFailureReport(skillDir, 'Skill directory not found');\n    }\n\n    const skillMdPath = join(skillDir, 'SKILL.md');\n    if (!existsSync(skillMdPath)) {\n      return this.createFailureReport(skillDir, 'SKILL.md not found');\n    }\n\n    // Parse SKILL.md\n    const parseResult = this.testSkillMdFormat(skillMdPath);\n    results.push(parseResult);\n\n    if (parseResult.status === 'fail') {\n      return this.createReport(skillDir, results);\n    }\n\n    const { frontmatter } = parseFrontmatter(readFileSync(skillMdPath, 'utf-8'));\n    const metadata = parseSkillMetadata(frontmatter);\n\n    // Run dependency tests\n    if (!this.options.skipDeps) {\n      const depsResult = await this.testDependencies(metadata);\n      results.push(depsResult);\n    }\n\n    // Run security tests\n    if (!this.options.skipSecurity) {\n      const securityResult = await this.testSecurity(skillDir);\n      results.push(securityResult);\n    }\n\n    // Run metadata tests\n    const metadataResult = this.testMetadata(metadata, skillDir);\n    results.push(metadataResult);\n\n    // Run example tests\n    if (!this.options.skipExamples) {\n      const content = readFileSync(skillMdPath, 'utf-8');\n      const examplesResult = await this.testExamples(content, skillDir);\n      results.push(examplesResult);\n    }\n\n    return this.createReport(skillDir, results);\n  }\n\n  /**\n   * Test SKILL.md format\n   */\n  testSkillMdFormat(filePath: string): TestResult {\n    const startTime = Date.now();\n    const details: string[] = [];\n\n    try {\n      const content = readFileSync(filePath, 'utf-8');\n\n      // Check for frontmatter\n      if (!content.startsWith('---')) {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Missing YAML frontmatter',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      const { frontmatter } = parseFrontmatter(content);\n\n      // Required fields\n      const requiredFields = ['name', 'description'];\n      for (const field of requiredFields) {\n        if (!frontmatter[field]) {\n          details.push(`Missing required field: ${field}`);\n        }\n      }\n\n      if (details.length > 0) {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Missing required frontmatter fields',\n          details,\n          duration: Date.now() - startTime,\n        };\n      }\n\n      // Validate field types\n      if (typeof frontmatter.name !== 'string') {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Field \"name\" must be a string',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      if (typeof frontmatter.description !== 'string') {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Field \"description\" must be a string',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      // Check for content after frontmatter\n      const { content: bodyContent } = parseFrontmatter(content);\n      if (!bodyContent || bodyContent.length < 10) {\n        return {\n          name: 'SKILL.md format',\n          status: 'warn',\n          message: 'SKILL.md body is too short',\n          details: ['Consider adding more detailed documentation'],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      return {\n        name: 'SKILL.md format',\n        status: 'pass',\n        message: 'Valid SKILL.md format',\n        duration: Date.now() - startTime,\n      };\n    } catch (err) {\n      return {\n        name: 'SKILL.md format',\n        status: 'fail',\n        message: err instanceof Error ? err.message : 'Failed to parse SKILL.md',\n        duration: Date.now() - startTime,\n      };\n    }\n  }\n\n  /**\n   * Test dependencies\n   */\n  async testDependencies(metadata: SkillMetadata): Promise<TestResult> {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasWarnings = false;\n    let hasFailures = false;\n\n    const requires = metadata.xopc?.requires;\n\n    if (!requires) {\n      return {\n        name: 'Dependencies',\n        status: 'skip',\n        message: 'No dependencies declared',\n        duration: Date.now() - startTime,\n      };\n    }\n\n    // Check required binaries\n    if (requires.bins) {\n      for (const bin of requires.bins) {\n        const available = hasBinary(bin);\n        if (!available) {\n          details.push(`Missing required binary: ${bin}`);\n          hasFailures = true;\n        } else {\n          details.push(`Found binary: ${bin}`);\n        }\n      }\n    }\n\n    // Check anyBins (OR condition)\n    if (requires.anyBins) {\n      const hasAny = requires.anyBins.some(bin => hasBinary(bin));\n      if (!hasAny) {\n        details.push(`Missing binaries (need one of): ${requires.anyBins.join(', ')}`);\n        hasFailures = true;\n      } else {\n        details.push(`Found at least one binary from: ${requires.anyBins.join(', ')}`);\n      }\n    }\n\n    // Check install specs\n    const installSpecs = metadata.xopc?.install;\n    if (installSpecs && installSpecs.length > 0) {\n      details.push(`Available installers: ${installSpecs.map(s => s.kind).join(', ')}`);\n      \n      // Validate install specs\n      for (const spec of installSpecs) {\n        const installCheck = this.validateInstallSpec(spec);\n        if (installCheck.status === 'fail') {\n          details.push(installCheck.message);\n          hasWarnings = true;\n        }\n      }\n    }\n\n    return {\n      name: 'Dependencies',\n      status: hasFailures ? 'fail' : hasWarnings ? 'warn' : 'pass',\n      message: hasFailures ? 'Missing dependencies' : hasWarnings ? 'Dependency warnings' : 'All dependencies satisfied',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Test security\n   */\n  async testSecurity(skillDir: string): Promise<TestResult> {\n    const startTime = Date.now();\n\n    try {\n      const summary = await scanSkillDirectory(skillDir);\n\n      const details: string[] = [\n        `Critical: ${summary.critical}`,\n        `Warnings: ${summary.warn}`,\n        `Info: ${summary.info}`,\n      ];\n\n      if (summary.critical > 0) {\n        return {\n          name: 'Security',\n          status: 'fail',\n          message: 'Critical security issues found',\n          details: [\n            ...details,\n            ...summary.findings\n              .filter(f => f.severity === 'critical')\n              .map(f => `${f.message} at ${relative(skillDir, f.file)}:${f.line}`),\n          ],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      if (summary.warn > 0) {\n        return {\n          name: 'Security',\n          status: 'warn',\n          message: 'Security warnings found',\n          details: [\n            ...details,\n            ...summary.findings\n              .filter(f => f.severity === 'warning')\n              .map(f => `${f.message} at ${relative(skillDir, f.file)}:${f.line}`),\n          ],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      return {\n        name: 'Security',\n        status: 'pass',\n        message: 'No security issues',\n        details,\n        duration: Date.now() - startTime,\n      };\n    } catch (err) {\n      return {\n        name: 'Security',\n        status: 'fail',\n        message: err instanceof Error ? err.message : 'Security scan failed',\n        duration: Date.now() - startTime,\n      };\n    }\n  }\n\n  /**\n   * Test metadata\n   */\n  testMetadata(metadata: SkillMetadata, _skillDir: string): TestResult {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasWarnings = false;\n\n    // Check for emoji\n    const emoji = metadata.xopc?.emoji;\n    if (emoji) {\n      details.push(`Emoji: ${emoji}`);\n    } else {\n      details.push('No emoji defined (recommended)');\n      hasWarnings = true;\n    }\n\n    // Check for homepage\n    if (metadata.homepage) {\n      details.push(`Homepage: ${metadata.homepage}`);\n    } else {\n      details.push('No homepage defined (recommended)');\n      hasWarnings = true;\n    }\n\n    // Check for OS restrictions\n    const os = metadata.xopc?.os;\n    if (os) {\n      details.push(`Supported OS: ${os.join(', ')}`);\n    }\n\n    // Check for install specs\n    const installSpecs = metadata.xopc?.install;\n    if (installSpecs && installSpecs.length > 0) {\n      details.push(`Installers: ${installSpecs.length} defined`);\n    }\n\n    return {\n      name: 'Metadata',\n      status: hasWarnings ? 'warn' : 'pass',\n      message: hasWarnings ? 'Metadata could be improved' : 'Complete metadata',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Test code examples\n   */\n  async testExamples(content: string, _skillDir: string): Promise<TestResult> {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasFailures = false;\n\n    // Extract code blocks\n    const codeBlocks = this.extractCodeBlocks(content);\n    \n    if (codeBlocks.length === 0) {\n      return {\n        name: 'Examples',\n        status: 'warn',\n        message: 'No code examples found',\n        details: ['Consider adding usage examples'],\n        duration: Date.now() - startTime,\n      };\n    }\n\n    details.push(`Found ${codeBlocks.length} code block(s)`);\n\n    // Test shell command examples (basic validation)\n    const shellCommands = codeBlocks.filter(block => {\n      const lang = block.language?.toLowerCase();\n      return lang === 'bash' || lang === 'sh' || lang === 'shell';\n    });\n\n    if (shellCommands.length > 0) {\n      details.push(`Shell examples: ${shellCommands.length}`);\n      \n      // Validate command syntax (basic check)\n      for (const cmd of shellCommands) {\n        const syntaxCheck = this.validateShellSyntax(cmd.code);\n        if (!syntaxCheck.valid) {\n          details.push(`Invalid syntax: ${syntaxCheck.error}`);\n          hasFailures = true;\n        }\n      }\n    }\n\n    return {\n      name: 'Examples',\n      status: hasFailures ? 'fail' : 'pass',\n      message: hasFailures ? 'Invalid examples found' : 'Examples validated',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  // ============================================================================\n  // Helper Methods\n  // ============================================================================\n\n  private validateInstallSpec(spec: SkillInstallSpec): TestResult {\n    switch (spec.kind) {\n      case 'brew':\n        if (!spec.formula) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Brew installer missing \"formula\" field',\n          };\n        }\n        break;\n      case 'pnpm':\n      case 'npm':\n      case 'yarn':\n      case 'bun':\n        if (!spec.package) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Node installer missing \"package\" field',\n          };\n        }\n        break;\n      case 'go':\n        if (!spec.module) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Go installer missing \"module\" field',\n          };\n        }\n        break;\n      case 'uv':\n        if (!spec.package) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'UV installer missing \"package\" field',\n          };\n        }\n        break;\n    }\n    return { name: 'Install spec', status: 'pass' };\n  }\n\n  private extractCodeBlocks(content: string): Array<{ language: string; code: string }> {\n    const blocks: Array<{ language: string; code: string }> = [];\n    const regex = /```(\\w+)?\\n([\\s\\S]*?)```/g;\n    let match;\n\n    while ((match = regex.exec(content)) !== null) {\n      blocks.push({\n        language: match[1] || 'text',\n        code: match[2].trim(),\n      });\n    }\n\n    return blocks;\n  }\n\n  private validateShellSyntax(code: string): { valid: boolean; error?: string } {\n    // Basic validation - check for common syntax errors\n    const lines = code.split('\\n').filter(line => line.trim() && !line.trim().startsWith('#'));\n    \n    for (const line of lines) {\n      // Check for unclosed quotes\n      const singleQuotes = (line.match(/'/g) || []).length;\n      const doubleQuotes = (line.match(/\"/g) || []).length;\n      \n      if (singleQuotes % 2 !== 0) {\n        return { valid: false, error: 'Unclosed single quote' };\n      }\n      if (doubleQuotes % 2 !== 0) {\n        return { valid: false, error: 'Unclosed double quote' };\n      }\n      \n      // Check for unclosed parentheses/brackets\n      const openParens = (line.match(/\\(/g) || []).length;\n      const closeParens = (line.match(/\\)/g) || []).length;\n      if (openParens !== closeParens) {\n        return { valid: false, error: 'Mismatched parentheses' };\n      }\n    }\n\n    return { valid: true };\n  }\n\n  private createReport(skillDir: string, results: TestResult[]): SkillTestReport {\n    const summary = {\n      total: results.length,\n      passed: results.filter(r => r.status === 'pass').length,\n      failed: results.filter(r => r.status === 'fail').length,\n      warnings: results.filter(r => r.status === 'warn').length,\n      skipped: results.filter(r => r.status === 'skip').length,\n    };\n\n    const passed = summary.failed === 0 && (this.options.strict ? summary.warnings === 0 : true);\n\n    return {\n      skillName: basename(skillDir),\n      skillPath: skillDir,\n      timestamp: Date.now(),\n      results,\n      summary,\n      passed,\n    };\n  }\n\n  private createFailureReport(skillDir: string, message: string): SkillTestReport {\n    return {\n      skillName: basename(skillDir),\n      skillPath: skillDir,\n      timestamp: Date.now(),\n      results: [{\n        name: 'Validation',\n        status: 'fail',\n        message,\n      }],\n      summary: {\n        total: 1,\n        passed: 0,\n        failed: 1,\n        warnings: 0,\n        skipped: 0,\n      },\n      passed: false,\n    };\n  }\n}\n\n// ============================================================================\n// Test Runner\n// ============================================================================\n\nexport interface TestRunnerOptions extends TestOptions {\n  /** Skills directory to test */\n  skillsDir: string;\n  /** Output format */\n  format?: 'text' | 'json' | 'tap';\n  /** Verbose output */\n  verbose?: boolean;\n}\n\nexport class SkillTestRunner {\n  private options: TestRunnerOptions;\n  private framework: SkillTestFramework;\n\n  constructor(options: TestRunnerOptions) {\n    this.options = options;\n    this.framework = new SkillTestFramework(options);\n  }\n\n  async run(): Promise<{ reports: SkillTestReport[]; passed: boolean }> {\n    const reports: SkillTestReport[] = [];\n    const skillsDir = this.options.skillsDir;\n\n    log.info({ skillsDir }, 'Running skill tests');\n\n    // Find all skill directories\n    const skillDirs = this.findSkillDirectories(skillsDir);\n\n    for (const skillDir of skillDirs) {\n      const report = await this.framework.testSkill(skillDir);\n      reports.push(report);\n    }\n\n    const allPassed = reports.every(r => r.passed);\n\n    return { reports, passed: allPassed };\n  }\n\n  private findSkillDirectories(skillsDir: string): string[] {\n    const dirs: string[] = [];\n\n    try {\n      const entries = readdirSync(skillsDir, { withFileTypes: true });\n      \n      for (const entry of entries) {\n        if (entry.isDirectory() && !entry.name.startsWith('.')) {\n          const skillDir = join(skillsDir, entry.name);\n          const skillMdPath = join(skillDir, 'SKILL.md');\n          \n          if (existsSync(skillMdPath)) {\n            dirs.push(skillDir);\n          }\n        }\n      }\n    } catch (err) {\n      log.warn({ error: err }, 'Failed to scan skills directory');\n    }\n\n    return dirs;\n  }\n}\n\n/**\n * Format test results as text\n */\nexport function formatTestResults(reports: SkillTestReport[], verbose = false): string {\n  const lines: string[] = [];\n  \n  for (const report of reports) {\n    const icon = report.passed ? '✅' : '❌';\n    lines.push(`\\n${icon} ${report.skillName}`);\n    lines.push('─'.repeat(50));\n\n    for (const result of report.results) {\n      const statusIcon = result.status === 'pass' ? '✓' : result.status === 'fail' ? '✗' : result.status === 'warn' ? '⚠' : '○';\n      lines.push(`  ${statusIcon} ${result.name}: ${result.message || ''}`);\n      \n      if (verbose && result.details) {\n        for (const detail of result.details) {\n          lines.push(`     ${detail}`);\n        }\n      }\n    }\n\n    lines.push(`  Summary: ${report.summary.passed}/${report.summary.total} passed`);\n    if (report.summary.failed > 0) {\n      lines.push(`  Failed: ${report.summary.failed}`);\n    }\n    if (report.summary.warnings > 0) {\n      lines.push(`  Warnings: ${report.summary.warnings}`);\n    }\n  }\n\n  const totalTests = reports.reduce((sum, r) => sum + r.summary.total, 0);\n  const totalPassed = reports.reduce((sum, r) => sum + r.summary.passed, 0);\n  const totalFailed = reports.reduce((sum, r) => sum + r.summary.failed, 0);\n  const totalWarnings = reports.reduce((sum, r) => sum + r.summary.warnings, 0);\n\n  lines.push('\\n' + '='.repeat(50));\n  lines.push(`Total: ${totalTests} tests, ${totalPassed} passed, ${totalFailed} failed, ${totalWarnings} warnings`);\n  \n  const allPassed = reports.every(r => r.passed);\n  lines.push(`Result: ${allPassed ? '✅ PASSED' : '❌ FAILED'}`);\n\n  return lines.join('\\n');\n}\n\n/**\n * Format test results as JSON\n */\nexport function formatTestResultsJson(reports: SkillTestReport[]): string {\n  return JSON.stringify({\n    timestamp: new Date().toISOString(),\n    totalSkills: reports.length,\n    passedSkills: reports.filter(r => r.passed).length,\n    reports,\n  }, null, 2);\n}\n\n/**\n * Format test results as TAP (Test Anything Protocol)\n */\nexport function formatTestResultsTap(reports: SkillTestReport[]): string {\n  const lines: string[] = [];\n  let testNum = 1;\n\n  lines.push(`TAP version 13`);\n  lines.push(`1..${reports.reduce((sum, r) => sum + r.results.length, 0)}`);\n\n  for (const report of reports) {\n    for (const result of report.results) {\n      const status = result.status === 'pass' ? 'ok' : 'not ok';\n      const testId = testNum++;\n      lines.push(`${status} ${testId} - ${report.skillName}: ${result.name}`);\n      \n      if (result.status === 'fail' && result.message) {\n        lines.push(`  ---`);\n        lines.push(`  message: ${result.message}`);\n        lines.push(`  ...`);\n      }\n    }\n  }\n\n  return lines.join('\\n');\n}\n"],"mappings":"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"}
+{"version":3,"file":"test-framework.js","names":[],"sources":["../../../../src/agent/skills/test-framework.ts"],"sourcesContent":["/**\n * Skill Test Framework\n * \n * Comprehensive testing framework for skills.\n * Validates SKILL.md format, dependencies, security, and examples.\n */\n\nimport { existsSync, readFileSync, readdirSync } from 'fs';\nimport { basename, join, relative } from 'path';\nimport { createLogger } from '../../utils/logger.js';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { parseSkillMetadata } from './parse-skill-metadata.js';\nimport { scanSkillDirectory } from './scanner.js';\nimport { hasBinary } from './installer.js';\nimport type { SkillMetadata, SkillInstallSpec } from './types.js';\n\nconst log = createLogger('SkillTestFramework');\n\n// ============================================================================\n// Test Result Types\n// ============================================================================\n\nexport type TestStatus = 'pass' | 'fail' | 'warn' | 'skip';\n\nexport interface TestResult {\n  name: string;\n  status: TestStatus;\n  message?: string;\n  details?: string[];\n  duration?: number;\n}\n\nexport interface SkillTestReport {\n  skillName: string;\n  skillPath: string;\n  timestamp: number;\n  results: TestResult[];\n  summary: {\n    total: number;\n    passed: number;\n    failed: number;\n    warnings: number;\n    skipped: number;\n  };\n  passed: boolean;\n}\n\nexport interface TestOptions {\n  /** Skip security tests */\n  skipSecurity?: boolean;\n  /** Skip dependency tests */\n  skipDeps?: boolean;\n  /** Skip example tests */\n  skipExamples?: boolean;\n  /** Strict mode - fail on warnings */\n  strict?: boolean;\n  /** Timeout for example tests (ms) */\n  exampleTimeout?: number;\n  /** Working directory for example tests */\n  cwd?: string;\n}\n\n// ============================================================================\n// Test Framework Core\n// ============================================================================\n\nexport class SkillTestFramework {\n  private options: TestOptions;\n\n  constructor(options: TestOptions = {}) {\n    this.options = {\n      skipSecurity: false,\n      skipDeps: false,\n      skipExamples: false,\n      strict: false,\n      exampleTimeout: 10000,\n      cwd: process.cwd(),\n      ...options,\n    };\n  }\n\n  /**\n   * Run all tests for a skill\n   */\n  async testSkill(skillDir: string): Promise<SkillTestReport> {\n    const results: TestResult[] = [];\n\n    log.info({ skillDir }, 'Testing skill');\n\n    // Validate skill directory\n    if (!existsSync(skillDir)) {\n      return this.createFailureReport(skillDir, 'Skill directory not found');\n    }\n\n    const skillMdPath = join(skillDir, 'SKILL.md');\n    if (!existsSync(skillMdPath)) {\n      return this.createFailureReport(skillDir, 'SKILL.md not found');\n    }\n\n    // Parse SKILL.md\n    const parseResult = this.testSkillMdFormat(skillMdPath);\n    results.push(parseResult);\n\n    if (parseResult.status === 'fail') {\n      return this.createReport(skillDir, results);\n    }\n\n    const { frontmatter } = parseFrontmatter(readFileSync(skillMdPath, 'utf-8'));\n    const metadata = parseSkillMetadata(frontmatter);\n\n    // Run dependency tests\n    if (!this.options.skipDeps) {\n      const depsResult = await this.testDependencies(metadata);\n      results.push(depsResult);\n    }\n\n    // Run security tests\n    if (!this.options.skipSecurity) {\n      const securityResult = await this.testSecurity(skillDir);\n      results.push(securityResult);\n    }\n\n    // Run metadata tests\n    const metadataResult = this.testMetadata(metadata, skillDir);\n    results.push(metadataResult);\n\n    // Run example tests\n    if (!this.options.skipExamples) {\n      const content = readFileSync(skillMdPath, 'utf-8');\n      const examplesResult = await this.testExamples(content, skillDir);\n      results.push(examplesResult);\n    }\n\n    return this.createReport(skillDir, results);\n  }\n\n  /**\n   * Test SKILL.md format\n   */\n  testSkillMdFormat(filePath: string): TestResult {\n    const startTime = Date.now();\n    const details: string[] = [];\n\n    try {\n      const content = readFileSync(filePath, 'utf-8');\n\n      // Check for frontmatter\n      if (!content.startsWith('---')) {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Missing YAML frontmatter',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      const { frontmatter } = parseFrontmatter(content);\n\n      // Required fields\n      const requiredFields = ['name', 'description'];\n      for (const field of requiredFields) {\n        if (!frontmatter[field]) {\n          details.push(`Missing required field: ${field}`);\n        }\n      }\n\n      if (details.length > 0) {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Missing required frontmatter fields',\n          details,\n          duration: Date.now() - startTime,\n        };\n      }\n\n      // Validate field types\n      if (typeof frontmatter.name !== 'string') {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Field \"name\" must be a string',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      if (typeof frontmatter.description !== 'string') {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Field \"description\" must be a string',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      // Check for content after frontmatter\n      const { content: bodyContent } = parseFrontmatter(content);\n      if (!bodyContent || bodyContent.length < 10) {\n        return {\n          name: 'SKILL.md format',\n          status: 'warn',\n          message: 'SKILL.md body is too short',\n          details: ['Consider adding more detailed documentation'],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      return {\n        name: 'SKILL.md format',\n        status: 'pass',\n        message: 'Valid SKILL.md format',\n        duration: Date.now() - startTime,\n      };\n    } catch (err) {\n      return {\n        name: 'SKILL.md format',\n        status: 'fail',\n        message: err instanceof Error ? err.message : 'Failed to parse SKILL.md',\n        duration: Date.now() - startTime,\n      };\n    }\n  }\n\n  /**\n   * Test dependencies\n   */\n  async testDependencies(metadata: SkillMetadata): Promise<TestResult> {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasWarnings = false;\n    let hasFailures = false;\n\n    const requires = metadata.xopc?.requires;\n\n    if (!requires) {\n      return {\n        name: 'Dependencies',\n        status: 'skip',\n        message: 'No dependencies declared',\n        duration: Date.now() - startTime,\n      };\n    }\n\n    // Check required binaries\n    if (requires.bins) {\n      for (const bin of requires.bins) {\n        const available = hasBinary(bin);\n        if (!available) {\n          details.push(`Missing required binary: ${bin}`);\n          hasFailures = true;\n        } else {\n          details.push(`Found binary: ${bin}`);\n        }\n      }\n    }\n\n    // Check anyBins (OR condition)\n    if (requires.anyBins) {\n      const hasAny = requires.anyBins.some(bin => hasBinary(bin));\n      if (!hasAny) {\n        details.push(`Missing binaries (need one of): ${requires.anyBins.join(', ')}`);\n        hasFailures = true;\n      } else {\n        details.push(`Found at least one binary from: ${requires.anyBins.join(', ')}`);\n      }\n    }\n\n    // Check install specs\n    const installSpecs = metadata.xopc?.install;\n    if (installSpecs && installSpecs.length > 0) {\n      details.push(`Available installers: ${installSpecs.map(s => s.kind).join(', ')}`);\n      \n      // Validate install specs\n      for (const spec of installSpecs) {\n        const installCheck = this.validateInstallSpec(spec);\n        if (installCheck.status === 'fail') {\n          details.push(installCheck.message);\n          hasWarnings = true;\n        }\n      }\n    }\n\n    return {\n      name: 'Dependencies',\n      status: hasFailures ? 'fail' : hasWarnings ? 'warn' : 'pass',\n      message: hasFailures ? 'Missing dependencies' : hasWarnings ? 'Dependency warnings' : 'All dependencies satisfied',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Test security\n   */\n  async testSecurity(skillDir: string): Promise<TestResult> {\n    const startTime = Date.now();\n\n    try {\n      const summary = await scanSkillDirectory(skillDir);\n\n      const details: string[] = [\n        `Critical: ${summary.critical}`,\n        `Warnings: ${summary.warn}`,\n        `Info: ${summary.info}`,\n      ];\n\n      if (summary.critical > 0) {\n        return {\n          name: 'Security',\n          status: 'fail',\n          message: 'Critical security issues found',\n          details: [\n            ...details,\n            ...summary.findings\n              .filter(f => f.severity === 'critical')\n              .map(f => `${f.message} at ${relative(skillDir, f.file)}:${f.line}`),\n          ],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      if (summary.warn > 0) {\n        return {\n          name: 'Security',\n          status: 'warn',\n          message: 'Security warnings found',\n          details: [\n            ...details,\n            ...summary.findings\n              .filter(f => f.severity === 'warning')\n              .map(f => `${f.message} at ${relative(skillDir, f.file)}:${f.line}`),\n          ],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      return {\n        name: 'Security',\n        status: 'pass',\n        message: 'No security issues',\n        details,\n        duration: Date.now() - startTime,\n      };\n    } catch (err) {\n      return {\n        name: 'Security',\n        status: 'fail',\n        message: err instanceof Error ? err.message : 'Security scan failed',\n        duration: Date.now() - startTime,\n      };\n    }\n  }\n\n  /**\n   * Test metadata\n   */\n  testMetadata(metadata: SkillMetadata, _skillDir: string): TestResult {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasWarnings = false;\n\n    // Check for emoji\n    const emoji = metadata.xopc?.emoji;\n    if (emoji) {\n      details.push(`Emoji: ${emoji}`);\n    } else {\n      details.push('No emoji defined (recommended)');\n      hasWarnings = true;\n    }\n\n    // Check for homepage\n    if (metadata.homepage) {\n      details.push(`Homepage: ${metadata.homepage}`);\n    } else {\n      details.push('No homepage defined (recommended)');\n      hasWarnings = true;\n    }\n\n    // Check for OS restrictions\n    const os = metadata.xopc?.os;\n    if (os) {\n      details.push(`Supported OS: ${os.join(', ')}`);\n    }\n\n    // Check for install specs\n    const installSpecs = metadata.xopc?.install;\n    if (installSpecs && installSpecs.length > 0) {\n      details.push(`Installers: ${installSpecs.length} defined`);\n    }\n\n    return {\n      name: 'Metadata',\n      status: hasWarnings ? 'warn' : 'pass',\n      message: hasWarnings ? 'Metadata could be improved' : 'Complete metadata',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Test code examples\n   */\n  async testExamples(content: string, _skillDir: string): Promise<TestResult> {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasFailures = false;\n\n    // Extract code blocks\n    const codeBlocks = this.extractCodeBlocks(content);\n    \n    if (codeBlocks.length === 0) {\n      return {\n        name: 'Examples',\n        status: 'warn',\n        message: 'No code examples found',\n        details: ['Consider adding usage examples'],\n        duration: Date.now() - startTime,\n      };\n    }\n\n    details.push(`Found ${codeBlocks.length} code block(s)`);\n\n    // Test shell command examples (basic validation)\n    const shellCommands = codeBlocks.filter(block => {\n      const lang = block.language?.toLowerCase();\n      return lang === 'bash' || lang === 'sh' || lang === 'shell';\n    });\n\n    if (shellCommands.length > 0) {\n      details.push(`Shell examples: ${shellCommands.length}`);\n      \n      // Validate command syntax (basic check)\n      for (const cmd of shellCommands) {\n        const syntaxCheck = this.validateShellSyntax(cmd.code);\n        if (!syntaxCheck.valid) {\n          details.push(`Invalid syntax: ${syntaxCheck.error}`);\n          hasFailures = true;\n        }\n      }\n    }\n\n    return {\n      name: 'Examples',\n      status: hasFailures ? 'fail' : 'pass',\n      message: hasFailures ? 'Invalid examples found' : 'Examples validated',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  // ============================================================================\n  // Helper Methods\n  // ============================================================================\n\n  private validateInstallSpec(spec: SkillInstallSpec): TestResult {\n    switch (spec.kind) {\n      case 'brew':\n        if (!spec.formula) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Brew installer missing \"formula\" field',\n          };\n        }\n        break;\n      case 'pnpm':\n      case 'npm':\n      case 'yarn':\n      case 'bun':\n        if (!spec.package) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Node installer missing \"package\" field',\n          };\n        }\n        break;\n      case 'go':\n        if (!spec.module) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Go installer missing \"module\" field',\n          };\n        }\n        break;\n      case 'uv':\n        if (!spec.package) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'UV installer missing \"package\" field',\n          };\n        }\n        break;\n    }\n    return { name: 'Install spec', status: 'pass' };\n  }\n\n  private extractCodeBlocks(content: string): Array<{ language: string; code: string }> {\n    const blocks: Array<{ language: string; code: string }> = [];\n    const regex = /```(\\w+)?\\n([\\s\\S]*?)```/g;\n    let match;\n\n    while ((match = regex.exec(content)) !== null) {\n      blocks.push({\n        language: match[1] || 'text',\n        code: match[2].trim(),\n      });\n    }\n\n    return blocks;\n  }\n\n  private validateShellSyntax(code: string): { valid: boolean; error?: string } {\n    // Basic validation - check for common syntax errors\n    const lines = code.split('\\n').filter(line => line.trim() && !line.trim().startsWith('#'));\n    \n    for (const line of lines) {\n      // Check for unclosed quotes\n      const singleQuotes = (line.match(/'/g) || []).length;\n      const doubleQuotes = (line.match(/\"/g) || []).length;\n      \n      if (singleQuotes % 2 !== 0) {\n        return { valid: false, error: 'Unclosed single quote' };\n      }\n      if (doubleQuotes % 2 !== 0) {\n        return { valid: false, error: 'Unclosed double quote' };\n      }\n      \n      // Check for unclosed parentheses/brackets\n      const openParens = (line.match(/\\(/g) || []).length;\n      const closeParens = (line.match(/\\)/g) || []).length;\n      if (openParens !== closeParens) {\n        return { valid: false, error: 'Mismatched parentheses' };\n      }\n    }\n\n    return { valid: true };\n  }\n\n  private createReport(skillDir: string, results: TestResult[]): SkillTestReport {\n    const summary = {\n      total: results.length,\n      passed: results.filter(r => r.status === 'pass').length,\n      failed: results.filter(r => r.status === 'fail').length,\n      warnings: results.filter(r => r.status === 'warn').length,\n      skipped: results.filter(r => r.status === 'skip').length,\n    };\n\n    const passed = summary.failed === 0 && (this.options.strict ? summary.warnings === 0 : true);\n\n    return {\n      skillName: basename(skillDir),\n      skillPath: skillDir,\n      timestamp: Date.now(),\n      results,\n      summary,\n      passed,\n    };\n  }\n\n  private createFailureReport(skillDir: string, message: string): SkillTestReport {\n    return {\n      skillName: basename(skillDir),\n      skillPath: skillDir,\n      timestamp: Date.now(),\n      results: [{\n        name: 'Validation',\n        status: 'fail',\n        message,\n      }],\n      summary: {\n        total: 1,\n        passed: 0,\n        failed: 1,\n        warnings: 0,\n        skipped: 0,\n      },\n      passed: false,\n    };\n  }\n}\n\n// ============================================================================\n// Test Runner\n// ============================================================================\n\nexport interface TestRunnerOptions extends TestOptions {\n  /** Skills directory to test */\n  skillsDir: string;\n  /** Output format */\n  format?: 'text' | 'json' | 'tap';\n  /** Verbose output */\n  verbose?: boolean;\n}\n\nexport class SkillTestRunner {\n  private options: TestRunnerOptions;\n  private framework: SkillTestFramework;\n\n  constructor(options: TestRunnerOptions) {\n    this.options = options;\n    this.framework = new SkillTestFramework(options);\n  }\n\n  async run(): Promise<{ reports: SkillTestReport[]; passed: boolean }> {\n    const reports: SkillTestReport[] = [];\n    const skillsDir = this.options.skillsDir;\n\n    log.info({ skillsDir }, 'Running skill tests');\n\n    // Find all skill directories\n    const skillDirs = this.findSkillDirectories(skillsDir);\n\n    for (const skillDir of skillDirs) {\n      const report = await this.framework.testSkill(skillDir);\n      reports.push(report);\n    }\n\n    const allPassed = reports.every(r => r.passed);\n\n    return { reports, passed: allPassed };\n  }\n\n  private findSkillDirectories(skillsDir: string): string[] {\n    const dirs: string[] = [];\n\n    try {\n      const entries = readdirSync(skillsDir, { withFileTypes: true });\n      \n      for (const entry of entries) {\n        if (entry.isDirectory() && !entry.name.startsWith('.')) {\n          const skillDir = join(skillsDir, entry.name);\n          const skillMdPath = join(skillDir, 'SKILL.md');\n          \n          if (existsSync(skillMdPath)) {\n            dirs.push(skillDir);\n          }\n        }\n      }\n    } catch (err) {\n      log.warn({ error: err }, 'Failed to scan skills directory');\n    }\n\n    return dirs;\n  }\n}\n\n/**\n * Format test results as text\n */\nexport function formatTestResults(reports: SkillTestReport[], verbose = false): string {\n  const lines: string[] = [];\n  \n  for (const report of reports) {\n    const icon = report.passed ? '✅' : '❌';\n    lines.push(`\\n${icon} ${report.skillName}`);\n    lines.push('─'.repeat(50));\n\n    for (const result of report.results) {\n      const statusIcon = result.status === 'pass' ? '✓' : result.status === 'fail' ? '✗' : result.status === 'warn' ? '⚠' : '○';\n      lines.push(`  ${statusIcon} ${result.name}: ${result.message || ''}`);\n      \n      if (verbose && result.details) {\n        for (const detail of result.details) {\n          lines.push(`     ${detail}`);\n        }\n      }\n    }\n\n    lines.push(`  Summary: ${report.summary.passed}/${report.summary.total} passed`);\n    if (report.summary.failed > 0) {\n      lines.push(`  Failed: ${report.summary.failed}`);\n    }\n    if (report.summary.warnings > 0) {\n      lines.push(`  Warnings: ${report.summary.warnings}`);\n    }\n  }\n\n  const totalTests = reports.reduce((sum, r) => sum + r.summary.total, 0);\n  const totalPassed = reports.reduce((sum, r) => sum + r.summary.passed, 0);\n  const totalFailed = reports.reduce((sum, r) => sum + r.summary.failed, 0);\n  const totalWarnings = reports.reduce((sum, r) => sum + r.summary.warnings, 0);\n\n  lines.push('\\n' + '='.repeat(50));\n  lines.push(`Total: ${totalTests} tests, ${totalPassed} passed, ${totalFailed} failed, ${totalWarnings} warnings`);\n  \n  const allPassed = reports.every(r => r.passed);\n  lines.push(`Result: ${allPassed ? '✅ PASSED' : '❌ FAILED'}`);\n\n  return lines.join('\\n');\n}\n\n/**\n * Format test results as JSON\n */\nexport function formatTestResultsJson(reports: SkillTestReport[]): string {\n  return JSON.stringify({\n    timestamp: new Date().toISOString(),\n    totalSkills: reports.length,\n    passedSkills: reports.filter(r => r.passed).length,\n    reports,\n  }, null, 2);\n}\n\n/**\n * Format test results as TAP (Test Anything Protocol)\n */\nexport function formatTestResultsTap(reports: SkillTestReport[]): string {\n  const lines: string[] = [];\n  let testNum = 1;\n\n  lines.push(`TAP version 13`);\n  lines.push(`1..${reports.reduce((sum, r) => sum + r.results.length, 0)}`);\n\n  for (const report of reports) {\n    for (const result of report.results) {\n      const status = result.status === 'pass' ? 'ok' : 'not ok';\n      const testId = testNum++;\n      lines.push(`${status} ${testId} - ${report.skillName}: ${result.name}`);\n      \n      if (result.status === 'fail' && result.message) {\n        lines.push(`  ---`);\n        lines.push(`  message: ${result.message}`);\n        lines.push(`  ...`);\n      }\n    }\n  }\n\n  return lines.join('\\n');\n}\n"],"mappings":"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"}

package/dist/src/agent/streaming/reasoning-visibility-sse.js

@@ -5,6 +5,7 @@
 function applyReasoningVisibilityToSseEvent(event, reasoningLevel) {
 	if (reasoningLevel !== "off") return event;
 	if (event.type === "thinking") return null;
+	if (event.type === "message_update" && event.assistantMessageEvent?.type === "thinking_delta") return null;
 	if (event.type === "progress" && event.stage === "thinking") return null;
 	return event;
 }

package/dist/src/agent/streaming/reasoning-visibility-sse.js.map

@@ -1 +1 @@
-{"version":3,"file":"reasoning-visibility-sse.js","names":[],"sources":["../../../../src/agent/streaming/reasoning-visibility-sse.ts"],"sourcesContent":["/**\n * Outbound SSE visibility for session `reasoningLevel`.\n * Single choke point: call from the queue push path so agent subscribe stays free of policy branches.\n *\n * Note: Does not alter persisted messages or agent state; history/UI may still strip thinking separately.\n */\n\nimport type { ReasoningLevel } from '../transcript/thinking-types.js';\n\nexport type SseStreamEvent = { type: string; [key: string]: unknown };\n\n/**\n * @returns `null` to drop the event; unchanged `event` otherwise.\n */\nexport function applyReasoningVisibilityToSseEvent(\n  event: SseStreamEvent,\n  reasoningLevel: ReasoningLevel,\n): SseStreamEvent | null {\n  if (reasoningLevel !== 'off') {\n    return event;\n  }\n  if (event.type === 'thinking') {\n    return null;\n  }\n  if (event.type === 'progress' && event.stage === 'thinking') {\n    return null;\n  }\n  return event;\n}\n"],"mappings":";;;;AAcA,SAAgB,mCACd,OACA,gBACuB;AACvB,KAAI,mBAAmB,MACrB,QAAO;AAET,KAAI,MAAM,SAAS,WACjB,QAAO;AAET,KAAI,MAAM,SAAS,cAAc,MAAM,UAAU,WAC/C,QAAO;AAET,QAAO"}
+{"version":3,"file":"reasoning-visibility-sse.js","names":[],"sources":["../../../../src/agent/streaming/reasoning-visibility-sse.ts"],"sourcesContent":["/**\n * Outbound SSE visibility for session `reasoningLevel`.\n * Single choke point: call from the queue push path so agent subscribe stays free of policy branches.\n *\n * Note: Does not alter persisted messages or agent state; history/UI may still strip thinking separately.\n */\n\nimport type { ReasoningLevel } from '../transcript/thinking-types.js';\n\nexport type SseStreamEvent = { type: string; [key: string]: unknown };\n\n/**\n * @returns `null` to drop the event; unchanged `event` otherwise.\n */\nexport function applyReasoningVisibilityToSseEvent(\n  event: SseStreamEvent,\n  reasoningLevel: ReasoningLevel,\n): SseStreamEvent | null {\n  if (reasoningLevel !== 'off') {\n    return event;\n  }\n  if (event.type === 'thinking') {\n    return null;\n  }\n  if (\n    event.type === 'message_update' &&\n    (event.assistantMessageEvent as { type?: unknown } | undefined)?.type === 'thinking_delta'\n  ) {\n    return null;\n  }\n  if (event.type === 'progress' && event.stage === 'thinking') {\n    return null;\n  }\n  return event;\n}\n"],"mappings":";;;;AAcA,SAAgB,mCACd,OACA,gBACuB;AACvB,KAAI,mBAAmB,MACrB,QAAO;AAET,KAAI,MAAM,SAAS,WACjB,QAAO;AAET,KACE,MAAM,SAAS,oBACd,MAAM,uBAA0D,SAAS,iBAE1E,QAAO;AAET,KAAI,MAAM,SAAS,cAAc,MAAM,UAAU,WAC/C,QAAO;AAET,QAAO"}

package/dist/src/agent/tool-manuals/browser.d.ts

@@ -0,0 +1 @@
+export declare const browserUseManual = "# Browser Tool Manual\n\n## Overview\n\n`browser_use` is XOPC's unified browser tool. It supports four modes:\n\n| Mode | Purpose |\n|------|---------|\n| `command` | Run a single browser action |\n| `pipeline` | Run a multi-step YAML flow |\n| `inspect` | Read current page state |\n| `close` | Close the browser session |\n\n## When to use\n\n- Open pages, click controls, fill forms\n- Capture screenshots or page content\n- Run multi-step automation flows\n- Extract data from pages\n\n## Command mode\n\n### Basic shape\n\n```json\n{\n  \"mode\": \"command\",\n  \"command\": \"<action>\",\n  \"args\": { ... }\n}\n```\n\n### Available commands\n\n| Command | Description | Key arguments |\n|---------|-------------|---------------|\n| `open` / `navigate` | Open a URL | `url`, `wait_until` |\n| `state` / `snapshot` | ARIA snapshot of the page | `selector`, `maxLength` |\n| `click` | Click an element | `selector` / `text` / `role` |\n| `type` / `input` | Type text | `selector` / `label`, `text`, `pressEnter` |\n| `scroll` | Scroll the page | `direction`, `amount` |\n| `screenshot` | Screenshot | `selector`, `full_page`, `path` |\n| `back` | Go back | `waitFor` |\n| `keys` / `press` | Keyboard input | `key` |\n| `console` / `eval` | Run JavaScript | `javascript` |\n| `images` | Collect images on the page | `selector`, `maxImages` |\n| `wait` | Wait for element/time | `selector` / `text` / `ms`, `timeout_ms` |\n| `dialog` | Handle dialogs | `action` (accept/dismiss) |\n| `close` | Close the current page | \u2014 |\n\n### Element targeting\n\nPrefer, in order:\n\n1. **ARIA role**: most stable, e.g. `\"role\": \"button:Submit\"`\n2. **Visible text**, e.g. `\"text\": \"Sign In\"`\n3. **CSS selector**, e.g. `\"selector\": \"#login-btn\"`\n\nGuidelines:\n\n- Use `inspect` or `state` first to get a snapshot\n- Pick locators from ARIA info in the snapshot\n- Avoid dynamic class names when possible\n\n## Inspect mode\n\nBefore acting, understand the current page:\n\n```json\n{ \"mode\": \"inspect\" }\n```\n\nReturns: current URL, title, ARIA snapshot.\n\n**Best practice**: after each navigation, inspect, then choose the next step.\n\n## Pipeline mode\n\nFor multi-step, reusable flows. Uses a brocli-style YAML DSL.\n\n### Run from file\n\n```json\n{\n  \"mode\": \"pipeline\",\n  \"pipeline\": {\n    \"path\": \"./browser-flow.yaml\",\n    \"args\": { \"url\": \"https://example.com\" }\n  }\n}\n```\n\n### Run inline YAML\n\n```json\n{\n  \"mode\": \"pipeline\",\n  \"pipeline\": {\n    \"yaml\": \"name: quick-check\\npipeline:\\n  - navigate:\\n      url: https://example.com\\n  - screenshot:\\n      full_page: true\",\n    \"dryRun\": false\n  }\n}\n```\n\n### YAML layout\n\n```yaml\nname: pipeline-name\ndescription: What this flow does\nargs:\n  url:\n    type: string\n    required: true\n  query:\n    type: string\n    default: \"hello\"\npipeline:\n  - navigate:\n      url: ${{ args.url }}\n      wait_until: domcontentloaded\n  - wait:\n      selector: input[name=\"q\"]\n  - type:\n      selector: input[name=\"q\"]\n      text: ${{ args.query }}\n  - press:\n      key: Enter\n  - wait:\n      selector: body\n      timeout_ms: 10000\n  - screenshot:\n      path: ./artifacts/result.png\n      full_page: true\n  - output:\n      value:\n        screenshot: ./artifacts/result.png\non_error:\n  - screenshot:\n      path: ./artifacts/error.png\n      full_page: true\n```\n\n### Authoring rules\n\n1. One action per step\n2. Use `${{ args.xxx }}` for parameters\n3. Use `${{ data }}` or `${{ data | json }}` for the previous step's result\n4. Use `on_error` to collect diagnostics after failure\n\n### Validate without running\n\n```json\n{\n  \"mode\": \"pipeline\",\n  \"pipeline\": {\n    \"yaml\": \"...\",\n    \"dryRun\": true\n  }\n}\n```\n\n## Recovery when something fails\n\n1. `inspect` to see current state\n2. Confirm the URL (redirects may have changed it)\n3. Use the snapshot to see if the page finished loading\n4. `screenshot` for visual debugging\n5. `wait` for elements, then retry\n\n## Safety\n\n- Do not put API keys or tokens in URLs\n- Do not target private IPs / localhost unless configuration allows it\n- Cloud metadata endpoints are always blocked\n- For destructive actions (submit forms, delete data), confirm intent with the user first\n";