@foggy-projects/deepseek-harness-plugin 0.4.0-beta.2

package/lib/client.js

@@ -0,0 +1,254 @@
+window.__ModuleLoader__.load({
+  id: '@foggy-projects/deepseek-harness-plugin',
+  factory: (require) => {
+    const module = { exports: {} }
+    const exports = module.exports
+    const { jsx, jsxs } = require('react/jsx-runtime')
+    const { useCallback, useEffect, useState } = require('react')
+
+    const NS = 'settings.foggy'
+    const passthroughSchema = { parse: (value) => value }
+    const TYPERT_REMOTE = {
+      package: '@foggy-projects/deepseek-harness-plugin',
+      descriptors: ['status', 'plan', 'initialize', 'repair', 'runtimeStart', 'runtimeStop'].map((method) => ({
+        id: `@foggy-projects/deepseek-harness-plugin#foggyIntegration/${method}`,
+        service: 'foggyIntegration',
+        namespace: 'foggyIntegration',
+        method,
+        invocation: { kind: 'direct' },
+        parameters: [],
+        result: {
+          mode: 'strict',
+          typeSymbol: '@foggy-projects/deepseek-harness-plugin#FoggyIntegrationResult',
+          schema: passthroughSchema,
+        },
+        sourceLocation: { file: 'lib/index.js', line: 1, column: 1 },
+      })),
+    }
+
+    const zh = {
+      tab: 'Foggy 数据分析',
+      title: 'Foggy Java 数据分析引擎',
+      intro: '在 DeepSeek Harness 内管理 Foggy CLI、Launcher、Skills 和本地 Runtime。大型组件在首次初始化时按需下载。',
+      refresh: '刷新状态',
+      loading: '正在读取 Foggy 状态…',
+      failed: '暂时无法读取 Foggy 状态。',
+      retry: '重试',
+      notInstalled: '尚未初始化',
+      degraded: '需要修复',
+      ready: '已就绪',
+      running: 'Runtime 运行中',
+      cli: 'CLI',
+      launcher: 'Launcher',
+      analysisSkill: '分析 Skill',
+      python: 'Python',
+      java: 'Java',
+      installed: '已安装',
+      missing: '未安装',
+      available: '可用',
+      unavailable: '不可用',
+      initialize: '初始化 Foggy',
+      repair: '重新下载 / 修复',
+      start: '启动 Runtime',
+      stop: '停止 Runtime',
+      working: '操作进行中…',
+      accepted: '操作已开始；页面会自动刷新状态。',
+      actionFailed: '操作失败',
+      roots: '本地目录',
+      installRoot: '组件目录',
+      dataRoot: '数据目录',
+      runtimeUrl: 'Runtime 地址',
+      projectRoot: 'Skill 目标工作区',
+      nextTitle: '后续配置',
+      nextCopy: 'Runtime 启动成功后，将继续进入数据库连接与语义层向导。数据库密码不会写入 DSH 普通设置。',
+      beta: 'Beta',
+    }
+
+    const en = {
+      tab: 'Foggy Data Analysis',
+      title: 'Foggy Java Data Analysis Engine',
+      intro: 'Manage the Foggy CLI, Launcher, Skills, and local Runtime inside DeepSeek Harness. Large components are downloaded on first initialization.',
+      refresh: 'Refresh status',
+      loading: 'Reading Foggy status…',
+      failed: 'Foggy status is temporarily unavailable.',
+      retry: 'Retry',
+      notInstalled: 'Not initialized',
+      degraded: 'Repair required',
+      ready: 'Ready',
+      running: 'Runtime running',
+      cli: 'CLI',
+      launcher: 'Launcher',
+      analysisSkill: 'Analysis Skill',
+      python: 'Python',
+      java: 'Java',
+      installed: 'Installed',
+      missing: 'Missing',
+      available: 'Available',
+      unavailable: 'Unavailable',
+      initialize: 'Initialize Foggy',
+      repair: 'Re-download / Repair',
+      start: 'Start Runtime',
+      stop: 'Stop Runtime',
+      working: 'Operation in progress…',
+      accepted: 'The operation started; this page will refresh automatically.',
+      actionFailed: 'Operation failed',
+      roots: 'Local directories',
+      installRoot: 'Components',
+      dataRoot: 'Data',
+      runtimeUrl: 'Runtime URL',
+      projectRoot: 'Skill target workspace',
+      nextTitle: 'Next configuration',
+      nextCopy: 'After the Runtime starts, the database connection and semantic-layer wizard comes next. Database passwords are never stored in ordinary DSH settings.',
+      beta: 'Beta',
+    }
+
+    const css = `
+      .foggy-settings{width:100%;max-width:820px;color:var(--dsw-alias-label-primary);display:flex;flex-direction:column;gap:16px}
+      .foggy-hero{border:1px solid var(--dsw-alias-border-l2);background:linear-gradient(135deg,color-mix(in srgb,var(--dsw-alias-state-business-primary) 10%,var(--dsw-alias-bg-layer-3)),var(--dsw-alias-bg-layer-3));border-radius:12px;padding:18px}
+      .foggy-title-row{display:flex;align-items:center;gap:10px}.foggy-title-row h3{margin:0;font-size:18px;line-height:26px}.foggy-beta{font-size:11px;padding:2px 7px;border-radius:999px;background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 14%,transparent);color:var(--dsw-alias-state-business-primary)}
+      .foggy-intro{margin:8px 0 0;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px}.foggy-toolbar{display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap}
+      .foggy-state{display:flex;align-items:center;gap:8px;font-size:14px;font-weight:600}.foggy-dot{width:9px;height:9px;border-radius:50%;background:var(--dsw-alias-label-tertiary)}.foggy-dot[data-state=ready],.foggy-dot[data-state=running]{background:var(--dsw-alias-state-success-primary)}.foggy-dot[data-state=degraded]{background:var(--dsw-alias-state-error-primary)}
+      .foggy-actions{display:flex;gap:8px;flex-wrap:wrap}.foggy-button{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);font:inherit;border-radius:8px;padding:7px 12px;cursor:pointer}.foggy-button:hover{background:var(--dsw-alias-interactive-bg-hover)}.foggy-button:disabled{opacity:.55;cursor:not-allowed}.foggy-button-primary{border-color:var(--dsw-alias-state-business-primary);background:var(--dsw-alias-state-business-primary);color:white}
+      .foggy-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:10px}.foggy-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:10px;padding:13px 14px}.foggy-card-head{display:flex;justify-content:space-between;gap:8px}.foggy-card strong{font-size:13px}.foggy-badge{font-size:11px;color:var(--dsw-alias-label-secondary)}.foggy-card code{display:block;margin-top:8px;color:var(--dsw-alias-label-tertiary);font-size:11px;overflow-wrap:anywhere}
+      .foggy-message{margin:0;font-size:13px;line-height:20px;color:var(--dsw-alias-label-secondary)}.foggy-message[data-error=true]{color:var(--dsw-alias-state-error-primary)}.foggy-paths,.foggy-next{border-top:1px solid var(--dsw-alias-border-l2);padding-top:14px}.foggy-paths h4,.foggy-next h4{margin:0 0 8px;font-size:13px}.foggy-paths dl{display:grid;grid-template-columns:100px minmax(0,1fr);gap:6px 10px;margin:0}.foggy-paths dt{color:var(--dsw-alias-label-tertiary);font-size:12px}.foggy-paths dd{margin:0;min-width:0;overflow-wrap:anywhere;font-family:var(--ds-font-family-code);font-size:11px}.foggy-next p{margin:0;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px}
+      @media (width<=680px){.foggy-grid{grid-template-columns:minmax(0,1fr)}}
+    `
+
+    if (typeof document !== 'undefined' && !document.querySelector('style[data-foggy-settings]')) {
+      const tag = document.createElement('style')
+      tag.dataset.foggySettings = 'true'
+      tag.textContent = css
+      document.head.appendChild(tag)
+    }
+
+    function unwrap(response, method) {
+      if (!response?.ok) {
+        const error = response?.error
+        throw new Error(error ? `${error.code}: ${error.message}` : `${method} failed`)
+      }
+      return response.value
+    }
+
+    function componentCard(label, component, kind, t) {
+      const available = kind === 'runtime' ? component?.installed : component?.available
+      const stateText = kind === 'runtime'
+        ? t(available ? 'installed' : 'missing')
+        : t(available ? 'available' : 'unavailable')
+      return jsxs('div', {
+        className: 'foggy-card',
+        children: [
+          jsxs('div', { className: 'foggy-card-head', children: [
+            jsx('strong', { children: label }),
+            jsx('span', { className: 'foggy-badge', children: stateText }),
+          ] }),
+          jsx('code', { children: `${component?.version || component?.output || '—'}${component?.minimum ? ` · ≥${component.minimum}` : ''}` }),
+        ],
+      })
+    }
+
+    function FoggySettingsTab({ api, t }) {
+      const [view, setView] = useState({ phase: 'loading', status: null, message: '', error: false })
+
+      const refresh = useCallback(async () => {
+        setView((current) => ({ ...current, phase: current.status ? 'ready' : 'loading', error: false }))
+        try {
+          const status = unwrap(await api.status(), 'status')
+          setView((current) => ({ ...current, phase: 'ready', status, error: false }))
+        } catch (error) {
+          setView((current) => ({ ...current, phase: current.status ? 'ready' : 'error', message: String(error.message || error), error: true }))
+        }
+      }, [api])
+
+      useEffect(() => { refresh() }, [refresh])
+      useEffect(() => {
+        if (view.status?.operation?.state !== 'running') return undefined
+        const timer = setInterval(refresh, 2000)
+        return () => clearInterval(timer)
+      }, [refresh, view.status?.operation?.state])
+
+      const run = async (method) => {
+        setView((current) => ({ ...current, message: t('working'), error: false }))
+        try {
+          const result = unwrap(await api[method](), method)
+          setView((current) => ({ ...current, message: result.accepted ? t('accepted') : '', error: result.success === false }))
+          await refresh()
+        } catch (error) {
+          setView((current) => ({ ...current, message: `${t('actionFailed')}: ${String(error.message || error)}`, error: true }))
+        }
+      }
+
+      if (view.phase === 'loading') return jsx('p', { className: 'foggy-message', children: t('loading') })
+      if (view.phase === 'error') return jsxs('div', { className: 'foggy-settings', children: [
+        jsx('p', { className: 'foggy-message', 'data-error': true, children: `${t('failed')} ${view.message}` }),
+        jsx('button', { className: 'foggy-button', type: 'button', onClick: refresh, children: t('retry') }),
+      ] })
+
+      const status = view.status
+      const busy = status.operation?.state === 'running'
+      const operationError = status.operation?.state === 'failed'
+        ? status.operation.error || status.operation.result?.error?.message || t('actionFailed')
+        : ''
+      const stateLabels = { 'not-installed': 'notInstalled', degraded: 'degraded', ready: 'ready', running: 'running' }
+      return jsxs('section', { className: 'foggy-settings', children: [
+        jsxs('div', { className: 'foggy-hero', children: [
+          jsxs('div', { className: 'foggy-title-row', children: [jsx('h3', { children: t('title') }), jsx('span', { className: 'foggy-beta', children: t('beta') })] }),
+          jsx('p', { className: 'foggy-intro', children: t('intro') }),
+        ] }),
+        jsxs('div', { className: 'foggy-toolbar', children: [
+          jsxs('div', { className: 'foggy-state', children: [jsx('span', { className: 'foggy-dot', 'data-state': status.state }), jsx('span', { children: t(stateLabels[status.state] || 'notInstalled') })] }),
+          jsxs('div', { className: 'foggy-actions', children: [
+            jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: refresh, children: t('refresh') }),
+            !status.installed ? jsx('button', { className: 'foggy-button foggy-button-primary', type: 'button', disabled: busy, onClick: () => run('initialize'), children: t('initialize') }) : null,
+            status.installed ? jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('repair'), children: t('repair') }) : null,
+            status.installed && !status.running && status.components.java.available ? jsx('button', { className: 'foggy-button foggy-button-primary', type: 'button', disabled: busy, onClick: () => run('runtimeStart'), children: t('start') }) : null,
+            status.running ? jsx('button', { className: 'foggy-button', type: 'button', disabled: busy, onClick: () => run('runtimeStop'), children: t('stop') }) : null,
+          ] }),
+        ] }),
+        busy || operationError || view.message ? jsx('p', { className: 'foggy-message', 'data-error': operationError || view.error ? 'true' : undefined, children: busy ? t('working') : operationError || view.message }) : null,
+        jsxs('div', { className: 'foggy-grid', children: [
+          componentCard(t('python'), status.components.python, 'tool', t),
+          componentCard(t('java'), status.components.java, 'tool', t),
+          componentCard(t('cli'), status.components.cli, 'runtime', t),
+          componentCard(t('launcher'), status.components.launcher, 'runtime', t),
+          componentCard(t('analysisSkill'), status.components.analysisSkill, 'runtime', t),
+        ] }),
+        jsxs('div', { className: 'foggy-paths', children: [
+          jsx('h4', { children: t('roots') }),
+          jsxs('dl', { children: [
+            jsx('dt', { children: t('installRoot') }), jsx('dd', { children: status.roots.installRoot }),
+            jsx('dt', { children: t('dataRoot') }), jsx('dd', { children: status.roots.dataRoot }),
+            jsx('dt', { children: t('projectRoot') }), jsx('dd', { children: status.projectRoot }),
+            status.runtimeUrl ? jsx('dt', { children: t('runtimeUrl') }) : null,
+            status.runtimeUrl ? jsx('dd', { children: status.runtimeUrl }) : null,
+          ] }),
+        ] }),
+        jsxs('div', { className: 'foggy-next', children: [jsx('h4', { children: t('nextTitle') }), jsx('p', { children: t('nextCopy') })] }),
+      ] })
+    }
+
+    const inject = ['slots', 'locale', 'remote']
+
+    async function apply(ctx) {
+      const disposeRemote = await ctx.remote.$mount(TYPERT_REMOTE)
+      ctx.effect(() => disposeRemote, 'foggy: remote contribution')
+      ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'foggy: settings dictionaries')
+      const t = ctx.locale.bind(NS)
+      ctx.inject(['remote.foggyIntegration'], (remoteCtx) => {
+        const api = remoteCtx.remote.foggyIntegration
+        remoteCtx.slots.inject('settings.plugins.tab', () => remoteCtx.slots.register({
+          name: 'settings.plugins.tab',
+          id: 'foggy',
+          order: 5,
+          label: () => t('tab'),
+          locale: NS,
+          inject: () => ({ api, t }),
+        }, FoggySettingsTab))
+      })
+    }
+
+    exports.NS = NS
+    exports.inject = inject
+    exports.apply = apply
+    return module.exports
+  },
+})

package/lib/index.js

@@ -0,0 +1,259 @@
+import { execFile } from 'node:child_process'
+import { access, readFile } from 'node:fs/promises'
+import { constants as fsConstants } from 'node:fs'
+import { dirname, join, delimiter } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { promisify } from 'node:util'
+import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol'
+import { compatible } from './version.js'
+
+const execFileAsync = promisify(execFile)
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
+const onboardingScript = join(packageRoot, 'skills', 'foggy-deepseek-onboarding', 'scripts', 'onboarding.py')
+const versionsFile = join(packageRoot, 'skills', 'foggy-deepseek-onboarding', 'assets', 'versions.json')
+
+function defaultRoots() {
+  if (process.platform === 'win32') {
+    const base = process.env.LOCALAPPDATA
+    if (!base) throw new Error('LOCALAPPDATA is not set')
+    return {
+      installRoot: join(base, 'Foggy', 'DeepSeekHarness'),
+      dataRoot: join(base, 'Foggy', 'DeepSeekHarnessData'),
+    }
+  }
+  const home = process.env.HOME
+  if (!home) throw new Error('HOME is not set')
+  return {
+    installRoot: process.env.XDG_DATA_HOME
+      ? join(process.env.XDG_DATA_HOME, 'foggy', 'deepseek-harness')
+      : join(home, '.local', 'share', 'foggy', 'deepseek-harness'),
+    dataRoot: process.env.XDG_STATE_HOME
+      ? join(process.env.XDG_STATE_HOME, 'foggy', 'deepseek-harness')
+      : join(home, '.local', 'state', 'foggy', 'deepseek-harness'),
+  }
+}
+
+async function exists(path) {
+  try {
+    await access(path, fsConstants.F_OK)
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function readJson(path) {
+  return JSON.parse(await readFile(path, 'utf8'))
+}
+
+async function commandVersion(command, args) {
+  try {
+    const { stdout, stderr } = await execFileAsync(command, args, {
+      windowsHide: true,
+      timeout: 15_000,
+      maxBuffer: 256 * 1024,
+    })
+    return { available: true, output: `${stdout}\n${stderr}`.trim().split(/\r?\n/)[0] ?? '' }
+  } catch (error) {
+    return { available: false, output: '', error: error.code ?? 'COMMAND_FAILED' }
+  }
+}
+
+async function pythonCommand() {
+  const configured = process.env.FOGGY_PYTHON
+  const candidates = configured ? [configured] : process.platform === 'win32' ? ['python', 'py'] : ['python3', 'python']
+  for (const command of candidates) {
+    const probe = await commandVersion(command, ['--version'])
+    if (probe.available) return command
+  }
+  throw new Error('Python 3.11+ was not found; set FOGGY_PYTHON to its executable')
+}
+
+function parseOutput(stdout, stderr) {
+  const text = String(stdout ?? '').trim()
+  if (!text) throw new Error(String(stderr ?? '').trim() || 'Foggy onboarding returned no JSON')
+  try {
+    return JSON.parse(text)
+  } catch {
+    throw new Error(`Foggy onboarding returned invalid JSON: ${text.slice(0, 240)}`)
+  }
+}
+
+async function runOnboarding(args, timeout = 15 * 60_000) {
+  const python = await pythonCommand()
+  try {
+    const { stdout, stderr } = await execFileAsync(python, [onboardingScript, ...args], {
+      windowsHide: true,
+      timeout,
+      maxBuffer: 4 * 1024 * 1024,
+      cwd: process.env.FOGGY_PROJECT_ROOT || process.cwd(),
+    })
+    return parseOutput(stdout, stderr)
+  } catch (error) {
+    if (error.stdout) return parseOutput(error.stdout, error.stderr)
+    throw error
+  }
+}
+
+function processRunning(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false
+  try {
+    process.kill(pid, 0)
+    return true
+  } catch {
+    return false
+  }
+}
+
+function operationView(operation) {
+  if (!operation) return { state: 'idle' }
+  const { promise: _promise, ...view } = operation
+  return view
+}
+
+export class FoggyIntegrationGateway extends TypertRemoteService {
+  operation = null
+
+  constructor(ctx) {
+    super(ctx, 'foggyIntegration')
+    for (const initialize of markerInitializers) initialize.call(this)
+  }
+
+  async status() {
+    const roots = defaultRoots()
+    const statePath = join(roots.installRoot, 'install-state.json')
+    const runtimeStatePath = join(roots.dataRoot, 'runtime-state.json')
+    const manifest = await readJson(versionsFile)
+    let pythonProbe
+    try {
+      pythonProbe = await commandVersion(await pythonCommand(), ['--version'])
+    } catch (error) {
+      pythonProbe = { available: false, output: '', error: String(error.message ?? error) }
+    }
+    const python = compatible(pythonProbe, '3.11')
+    const java = compatible(await commandVersion(process.env.JAVA_EXE || 'java', ['-version']), '17.0')
+    let state = null
+    let runtime = null
+    try { state = await readJson(statePath) } catch {}
+    try { runtime = await readJson(runtimeStatePath) } catch {}
+    const cliPath = state?.cli?.command
+    const launcherPath = state?.launcher?.path
+    const components = {
+      python,
+      java,
+      cli: {
+        installed: Boolean(cliPath && await exists(cliPath)),
+        version: state?.cli?.version ?? manifest.components.cli.version,
+      },
+      launcher: {
+        installed: Boolean(launcherPath && await exists(launcherPath)),
+        version: state?.launcher?.version ?? manifest.components.launcher.version,
+      },
+      analysisSkill: {
+        installed: Boolean(state?.skills?.analysis?.path && await exists(state.skills.analysis.path)),
+        version: state?.skills?.analysis?.version ?? manifest.components.analysisSkill.version,
+      },
+    }
+    const installed = components.cli.installed && components.launcher.installed && components.analysisSkill.installed
+    const running = Boolean(runtime && processRunning(Number(runtime.pid)))
+    return {
+      success: true,
+      packageVersion: manifest.packageVersion,
+      state: running ? 'running' : installed ? 'ready' : state ? 'degraded' : 'not-installed',
+      installed,
+      running,
+      runtimeUrl: running ? runtime.runtimeUrl ?? null : null,
+      roots,
+      projectRoot: process.env.FOGGY_PROJECT_ROOT || process.cwd(),
+      components,
+      operation: operationView(this.operation),
+      next: installed ? (running ? 'configure-database' : 'start-runtime') : 'initialize',
+    }
+  }
+
+  async plan() {
+    const roots = defaultRoots()
+    const manifest = await readJson(versionsFile)
+    return {
+      success: true,
+      roots,
+      projectRoot: process.env.FOGGY_PROJECT_ROOT || process.cwd(),
+      versions: Object.fromEntries(Object.entries(manifest.components).map(([name, value]) => [name, value.version])),
+      operations: [
+        'create isolated Python environment',
+        'download and verify pinned CLI and Launcher assets',
+        'install Foggy analysis and onboarding Skills into the workspace',
+        'write local install state',
+      ],
+      secretsInDshSettings: false,
+    }
+  }
+
+  async initialize() {
+    return this.startOperation('initialize', false)
+  }
+
+  async repair() {
+    return this.startOperation('repair', true)
+  }
+
+  async runtimeStart() {
+    return this.startOperation('runtime-start', false, ['runtime-start'])
+  }
+
+  async runtimeStop() {
+    return this.startOperation('runtime-stop', false, ['runtime-stop'])
+  }
+
+  startOperation(kind, replaceSkill, explicitArgs) {
+    if (this.operation?.state === 'running') {
+      return { success: false, accepted: false, operation: operationView(this.operation), error: 'another Foggy operation is running' }
+    }
+    const id = `${Date.now()}-${Math.random().toString(16).slice(2, 10)}`
+    const args = explicitArgs ?? ['install', '--project-root', process.env.FOGGY_PROJECT_ROOT || process.cwd()]
+    if (replaceSkill) args.push('--replace-skill')
+    for (const cacheDir of (process.env.FOGGY_ASSET_CACHE_DIRS || '').split(delimiter).filter(Boolean)) {
+      args.push('--asset-cache-dir', cacheDir)
+    }
+    const operation = {
+      id,
+      kind,
+      state: 'running',
+      startedAt: new Date().toISOString(),
+      finishedAt: null,
+      result: null,
+      error: null,
+      promise: null,
+    }
+    operation.promise = runOnboarding(args)
+      .then((result) => {
+        operation.state = result.success === false ? 'failed' : 'succeeded'
+        operation.result = result
+        operation.finishedAt = new Date().toISOString()
+      })
+      .catch((error) => {
+        operation.state = 'failed'
+        operation.error = String(error.message ?? error)
+        operation.finishedAt = new Date().toISOString()
+      })
+    this.operation = operation
+    return { success: true, accepted: true, operation: operationView(operation) }
+  }
+}
+
+const markerInitializers = []
+for (const method of ['status', 'plan', 'initialize', 'repair', 'runtimeStart', 'runtimeStop']) {
+  Remote(method)(FoggyIntegrationGateway.prototype[method], {
+    kind: 'method',
+    name: method,
+    static: false,
+    private: false,
+    access: {
+      has: (object) => method in object,
+      get: (object) => object[method],
+    },
+    addInitializer: (initializer) => markerInitializers.push(initializer),
+  })
+}
+
+export default FoggyIntegrationGateway

package/lib/remote-descriptor.js

@@ -0,0 +1,29 @@
+import { z } from 'zod'
+
+const resultSchema = z.unknown()
+
+function descriptor(method) {
+  return {
+    id: `@foggy-projects/deepseek-harness-plugin#foggyIntegration/${method}`,
+    service: 'foggyIntegration',
+    namespace: 'foggyIntegration',
+    method,
+    invocation: { kind: 'direct' },
+    parameters: [],
+    result: {
+      mode: 'strict',
+      typeSymbol: '@foggy-projects/deepseek-harness-plugin#FoggyIntegrationResult',
+      schema: resultSchema,
+    },
+    sourceLocation: { file: 'lib/index.js', line: 1, column: 1 },
+  }
+}
+
+export const descriptors = [
+  descriptor('status'),
+  descriptor('plan'),
+  descriptor('initialize'),
+  descriptor('repair'),
+  descriptor('runtimeStart'),
+  descriptor('runtimeStop'),
+]

package/lib/remote.js

@@ -0,0 +1,8 @@
+import { descriptors } from './remote-descriptor.js'
+
+export const TYPERT_REMOTE = {
+  package: '@foggy-projects/deepseek-harness-plugin',
+  descriptors,
+}
+
+export default TYPERT_REMOTE

package/lib/typert.js

@@ -0,0 +1,9 @@
+import { descriptors } from './remote-descriptor.js'
+
+export const TYPERT = {
+  package: '@foggy-projects/deepseek-harness-plugin',
+  face: 'host',
+  schemas: [],
+  invocations: descriptors,
+  model: { services: [], events: [], objects: [] },
+}

package/lib/version.js

@@ -0,0 +1,15 @@
+export function versionParts(text) {
+  const match = String(text).match(/(\d+)(?:\.(\d+))?(?:\.(\d+))?/)
+  return match ? match.slice(1).map((part) => Number(part || 0)) : []
+}
+
+export function compatible(probe, minimum) {
+  if (!probe.available) return { ...probe, detected: false, minimum }
+  const actual = versionParts(probe.output)
+  const wanted = versionParts(minimum)
+  for (let index = 0; index < wanted.length; index += 1) {
+    if ((actual[index] ?? 0) > wanted[index]) return { ...probe, detected: true, available: true, minimum }
+    if ((actual[index] ?? 0) < wanted[index]) return { ...probe, detected: true, available: false, minimum }
+  }
+  return { ...probe, detected: true, available: true, minimum }
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@foggy-projects/deepseek-harness-plugin",
+  "version": "0.4.0-beta.2",
+  "description": "Foggy Java data analysis engine integration for DeepSeek Harness",
+  "type": "module",
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./typert": "./lib/typert.js",
+    "./remote": "./lib/remote.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/**/*.js",
+    "skills/**",
+    "!skills/**/__pycache__/**",
+    "!skills/**/*.pyc",
+    "cordis.patch.yml",
+    "experience/linux/**",
+    "README.md"
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
+      ]
+    }
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.1-rc.2"
+  },
+  "scripts": {
+    "check": "node --check lib/index.js && node --check lib/client.js && node --check lib/typert.js && node --check lib/remote.js",
+    "test": "node --test test/package.test.js"
+  }
+}