dsh-bailinghub 0.2.0 → 0.3.0

package/lib/runtime.js

@@ -31,6 +31,7 @@ const INVOCATION_STATES = new Set([
 const DEFAULT_RESUME_POLL_INTERVAL_MILLISECONDS = 2_000
 const DEFAULT_RESUME_MAX_WAIT_MILLISECONDS = 120_000
 const DEFAULT_RESUME_MAX_ATTEMPTS = 60
+export const TESTED_DSH_HOST_RELEASES = Object.freeze(['0.1.0-rc.7', '0.1.1-rc.2'])
 const SENSITIVE_TEXT = [
   /\bBearer\s+[A-Za-z0-9._~+\/-]+=*/gi,
   /([?&](?:access_token|code|credential|secret|token)=)[^&#\s]+/gi,
@@ -63,6 +64,116 @@ function commandText(value) {
   return text || '(no additional details)'
 }
 
+function loginCommandText(value) {
+  if (
+    value === null ||
+    typeof value !== 'object' ||
+    Array.isArray(value) ||
+    value.state !== 'authorized' ||
+    value.cleanupRequired !== true
+  ) {
+    return commandText(value)
+  }
+
+  const cleanupNames = Array.isArray(value.cleanupConnections)
+    ? value.cleanupConnections
+      .map((connection) => redactText(
+        connection?.connectionName ?? connection?.connectionKey ?? '',
+      ).replace(/\s+/gu, ' ').trim())
+      .filter(Boolean)
+    : []
+  const pending = cleanupNames.length > 0
+    ? ` Pending cleanup: ${cleanupNames.join(', ')}.`
+    : ''
+  return [
+    'Authorization succeeded. The selected connection remains authorized.',
+    `WARNING: an existing connection still requires cleanup.${pending}`,
+    'Do not authorize again. Use /bailinghub connections list, then /bailinghub connections remove <name-or-key> to retry cleanup.',
+    commandText(value),
+  ].join('\n')
+}
+
+export function parseCommandArguments(value) {
+  const tokens = []
+  let current = ''
+  let quote = ''
+  let escaped = false
+  let started = false
+  for (const character of String(value ?? '')) {
+    if (escaped) {
+      current += character
+      escaped = false
+      started = true
+      continue
+    }
+    if (character === '\\') {
+      escaped = true
+      started = true
+      continue
+    }
+    if (quote) {
+      if (character === quote) quote = ''
+      else current += character
+      continue
+    }
+    if (character === '"' || character === "'") {
+      quote = character
+      started = true
+      continue
+    }
+    if (/\s/u.test(character)) {
+      if (started) {
+        tokens.push(current)
+        current = ''
+        started = false
+      }
+      continue
+    }
+    current += character
+    started = true
+  }
+  if (quote || escaped) throw new TypeError('BailingHub command contains an unfinished quote or escape')
+  if (started) tokens.push(current)
+  return tokens
+}
+
+function inspectHostContract(ctx) {
+  const capabilities = {
+    events: typeof ctx?.on === 'function',
+    commands: typeof ctx?.commands?.register === 'function',
+    effects: typeof ctx?.effect === 'function',
+    services: typeof ctx?.provide === 'function',
+  }
+  return {
+    ok: Object.values(capabilities).every(Boolean),
+    capabilities,
+    host_contract_tested_releases: [...TESTED_DSH_HOST_RELEASES],
+  }
+}
+
+function doctorText(report) {
+  const label = (check) => (check?.ok ? 'PASS' : check?.skipped ? 'SKIP' : 'FAIL')
+  const configuration = report.checks.configuration
+  const authorization = report.checks.agent_session
+  const workspace = report.checks.workspace
+  const lines = [
+    'BailingHub Agent Client doctor',
+    `Overall: ${report.ok ? 'PASS' : 'FAIL'}`,
+    `- Configuration: ${label(configuration)}`,
+    `- DSH host contract: ${label(report.checks.dsh_host)} (host-contract tests: ${TESTED_DSH_HOST_RELEASES.join(', ')})`,
+    `- Agent Client SDK: ${label(report.checks.sdk)}`,
+    '- Connection selector: connectionName is a local user-selected label, not a business identity claim',
+    '- Business identity: the single business authorization page handles sign-in, account switching, and tenant selection',
+    `- Authorization: ${label(authorization)} (${authorization.state})`,
+    `- Workspace: ${label(workspace)}${Number.isSafeInteger(workspace.authorized_count) ? ` (${workspace.authorized_count} authorized)` : ''}`,
+  ]
+  if (configuration.invalid?.length) {
+    lines.push(`- Invalid configuration fields: ${configuration.invalid.join(', ')}`)
+  }
+  if (report.next_action) lines.push(`Next action: ${report.next_action}`)
+  return lines.join('\n')
+}
+
 function redactText(value) {
   let text = String(value ?? '')
   for (const pattern of SENSITIVE_TEXT) {
@@ -249,6 +360,46 @@ export function normalizeConfig(config = {}) {
   return { ...normalized, valid: invalid.length === 0, invalid }
 }
 
+function currentConnectionDefaults(value) {
+  if (value === null || typeof value !== 'object' || Array.isArray(value)) return undefined
+
+  const currentConnectionKey = typeof value.currentConnectionKey === 'string'
+    ? value.currentConnectionKey.trim()
+    : ''
+  if (!currentConnectionKey || currentConnectionKey.length > 128 || !Array.isArray(value.connections)) {
+    return undefined
+  }
+
+  const selected = value.connections.find((entry) =>
+    entry !== null &&
+    typeof entry === 'object' &&
+    !Array.isArray(entry) &&
+    typeof entry.connectionKey === 'string' &&
+    entry.connectionKey.trim() === currentConnectionKey,
+  )
+  if (!selected) return undefined
+
+  const connectionName = typeof selected.connectionName === 'string'
+    ? selected.connectionName.trim()
+    : ''
+  const normalized = normalizeConfig({
+    hubUrl: selected.hubUrl,
+    clientAppId: selected.clientAppId,
+    workspace: selected.workspace,
+    connectionName: connectionName || currentConnectionKey,
+  })
+  return normalized.valid ? normalized : undefined
+}
+
+function connectionRegistryIsEmpty(value) {
+  return value !== null &&
+    typeof value === 'object' &&
+    !Array.isArray(value) &&
+    Array.isArray(value.connections) &&
+    value.connections.length === 0 &&
+    (value.currentConnectionKey === null || value.currentConnectionKey === undefined)
+}
+
 function visibleText(message) {
   if (!Array.isArray(message?.content)) return ''
   return message.content
@@ -591,7 +742,14 @@ export class BailingHubAgentClientRuntime {
     this.config = normalizeConfig(config)
     this.getTransport = getTransport
     this.recovery = normalizeRecoveryOptions(recoveryOptions)
+    this.hostContract = inspectHostContract(ctx)
     this.defaultWorkspace = this.config.workspace
+    this.defaultConnectionName = this.config.connectionName
+    this.defaultHubUrl = this.config.hubUrl
+    this.defaultClientAppId = this.config.clientAppId
+    this.connectionReady = this.config.valid
+    this.connectionBootstrap = undefined
+    this.pendingClaimsByAgent = new WeakMap()
     this.states = new Set()
     this.statesByAgent = new WeakMap()
     this.statesBySessionId = new Map()
@@ -607,8 +765,8 @@ export class BailingHubAgentClientRuntime {
     this.ctx.on('session/disposed', (session) => void this.disposeSession(session.id))
     const registerCommand = () => this.ctx.commands.register({
       name: 'bailinghub',
-      description: 'authorize, inspect, or resync the BailingHub Agent Client connection',
-      input: { hint: 'login|status|logout|workspaces|use <workspace>|sync' },
+      description: 'authorize, diagnose, inspect, switch, or resync BailingHub Agent Client connections',
+      input: { hint: 'doctor|connections list|add|use|remove|login|status|logout|workspaces|use <workspace>|sync' },
       handler: (invocation) => this.handleCommand(invocation),
     })
     if (typeof this.ctx.effect === 'function') this.ctx.effect(registerCommand)
@@ -618,12 +776,47 @@ export class BailingHubAgentClientRuntime {
   }
 
   async handleCommand(invocation) {
+    await this.restoreCurrentConnection()
     const input = invocation.rawInput.trim()
-    const [action, ...rest] = input ? input.split(/\s+/u) : ['status']
     try {
+      const [action = 'status', ...rest] = parseCommandArguments(input)
       switch (action) {
+        case 'connections': {
+          const [operation = 'list', ...parameters] = rest
+          if (operation === 'list' && parameters.length === 0) {
+            return { kind: 'success', text: commandText(await this.connectionsList()) }
+          }
+          if (operation === 'add' && parameters.length === 4) {
+            const [connectionName, hubUrl, clientAppId, workspace] = parameters
+            const result = await this.connectionsAdd({ connectionName, hubUrl, clientAppId, workspace })
+            const action = result?.state === 'selected' ? 'selected' : 'registered and selected'
+            return {
+              kind: 'success',
+              text: `Connection instance ${action} for new sessions: ${connectionName}\n${commandText(result)}`,
+            }
+          }
+          if (operation === 'use' && parameters.length === 1) {
+            const result = await this.connectionsUse(parameters[0])
+            return {
+              kind: 'success',
+              text: `Connection selected for new sessions: ${parameters[0]}\n${commandText(result)}`,
+            }
+          }
+          if (operation === 'remove' && parameters.length === 1) {
+            const result = await this.connectionsRemove(parameters[0])
+            return { kind: 'success', text: commandText(result) }
+          }
+          return {
+            kind: 'error',
+            text: 'Usage: /bailinghub connections list|add <name> <hub-url> <client-app-id> <workspace>|use <name-or-key>|remove <name-or-key>',
+          }
+        }
+        case 'doctor': {
+          const result = await this.doctor()
+          return { kind: result.ok ? 'success' : 'error', text: doctorText(result) }
+        }
         case 'login':
-          return { kind: 'success', text: commandText(await this.login()) }
+          return { kind: 'success', text: loginCommandText(await this.login()) }
         case 'status':
           return { kind: 'success', text: commandText(await this.status()) }
         case 'logout':
@@ -648,7 +841,7 @@ export class BailingHubAgentClientRuntime {
         default:
           return {
             kind: 'error',
-            text: 'Usage: /bailinghub login|status|logout|workspaces|use <workspace>|sync',
+            text: 'Usage: /bailinghub doctor|connections list|add|use|remove|login|status|logout|workspaces|use <workspace>|sync',
           }
       }
     } catch (error) {
@@ -663,8 +856,13 @@ export class BailingHubAgentClientRuntime {
     let state = this.statesByAgent.get(agent)
     if (state) return state
 
-    state = createState(agent, this.defaultWorkspace, this.config.connectionName)
-    if (!this.config.valid) {
+    state = createState(agent, this.defaultWorkspace, this.defaultConnectionName)
+    const pendingClaims = this.pendingClaimsByAgent.get(agent)
+    if (pendingClaims) {
+      state.pendingClaims = pendingClaims
+      this.pendingClaimsByAgent.delete(agent)
+    }
+    if (!this.connectionReady) {
       state.status = {
         state: 'unconfigured',
         missing: [...this.config.invalid],
@@ -678,17 +876,23 @@ export class BailingHubAgentClientRuntime {
 
   onInboxClaimed({ agent, message, turn }) {
     if (message?.source?.kind !== 'user') return
-    const state = this.stateFor(agent)
+    const state = this.statesByAgent.get(agent)
+    let pendingClaims = state?.pendingClaims ?? this.pendingClaimsByAgent.get(agent)
+    if (!pendingClaims) {
+      pendingClaims = new Map()
+      this.pendingClaimsByAgent.set(agent, pendingClaims)
+    }
+    const sessionId = String(agent.session.id)
     const rawMessageId = String(
-      message.id ?? messageAlias('source', state.sessionId, String(turn), visibleText(message)),
+      message.id ?? messageAlias('source', sessionId, String(turn), visibleText(message)),
     )
     const claim = {
-      id: messageAlias('user', state.sessionId, String(turn), rawMessageId),
+      id: messageAlias('user', sessionId, String(turn), rawMessageId),
       text: visibleText(message),
     }
-    const claims = state.pendingClaims.get(turn) ?? []
+    const claims = pendingClaims.get(turn) ?? []
     claims.push(claim)
-    state.pendingClaims.set(turn, claims)
+    pendingClaims.set(turn, claims)
   }
 
   async onAssemble(assembly, context, next) {
@@ -696,6 +900,7 @@ export class BailingHubAgentClientRuntime {
     const agent = context?.agent
     if (!agent) return base
 
+    await this.restoreCurrentConnection()
     const state = this.stateFor(agent)
     const turn = Math.max(...state.pendingClaims.keys(), -1)
     let removedNames = new Set()
@@ -712,7 +917,7 @@ export class BailingHubAgentClientRuntime {
       await this.clearActiveTools(state)
       if (state.currentRun?.status === 'active') {
         state.currentRun.status = 'degraded'
-        state.currentRun.degradedReason = 'DSH Code Mode is not supported by this candidate'
+        state.currentRun.degradedReason = 'DSH Code Mode is not supported by this plugin version'
       }
       state.status = { state: 'degraded', reason: 'unsupported DSH tool presentation mode' }
     }
@@ -738,7 +943,7 @@ export class BailingHubAgentClientRuntime {
     const removedNames = new Set(state.knownToolNames)
     await this.clearActiveTools(state)
 
-    if (!this.config.valid) {
+    if (!this.connectionReady) {
       const run = { turn, status: 'unconfigured', degradedReason: 'configuration required' }
       state.runs.set(turn, run)
       state.currentRun = run
@@ -1101,7 +1306,7 @@ export class BailingHubAgentClientRuntime {
 
     if (!run || run.status !== 'active') {
       tools = tools.filter((tool) => !state.knownToolNames.has(tool.name))
-      const reason = run?.degradedReason ?? (this.config.valid ? 'no active user turn' : 'configuration required')
+      const reason = run?.degradedReason ?? (this.connectionReady ? 'no active user turn' : 'configuration required')
       sections = replaceNamed(sections, degradedSection(reason))
       return { ...base, sections, contexts, tools }
     }
@@ -1234,34 +1439,162 @@ export class BailingHubAgentClientRuntime {
     return { synced, pending }
   }
 
+  async restoreCurrentConnection() {
+    if (!this.connectionBootstrap) {
+      this.connectionBootstrap = this.restoreCurrentConnectionOnce()
+    }
+    return this.connectionBootstrap
+  }
+
+  async restoreCurrentConnectionOnce() {
+    if (!this.config.valid) return false
+
+    try {
+      const selected = currentConnectionDefaults(await this.connectionsList())
+      if (!selected) return false
+      this.applyConnectionDefaults(selected)
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  applyConnectionDefaults(selected) {
+    this.defaultConnectionName = selected.connectionName
+    this.defaultWorkspace = selected.workspace
+    this.defaultHubUrl = selected.hubUrl
+    this.defaultClientAppId = selected.clientAppId
+    this.connectionReady = true
+  }
+
   async login(options = {}) {
-    return this.callConnection('login', {
-      hubUrl: this.config.hubUrl,
-      clientAppId: this.config.clientAppId,
+    const result = await this.callConnection('login', {
+      hubUrl: this.defaultHubUrl,
+      clientAppId: this.defaultClientAppId,
       workspace: options.workspace ?? this.defaultWorkspace,
       route: options.workspace ?? this.defaultWorkspace,
-      connectionName: options.connectionName ?? this.config.connectionName,
+      connectionName: options.connectionName ?? this.defaultConnectionName,
     })
+    const selectedConnectionName = typeof result?.connectionName === 'string'
+      ? result.connectionName.trim()
+      : ''
+    if (
+      result?.state === 'authorized' &&
+      selectedConnectionName &&
+      selectedConnectionName.length <= 128
+    ) {
+      this.defaultConnectionName = selectedConnectionName
+      if (typeof result.workspace === 'string' && WORKSPACE.test(result.workspace)) {
+        this.defaultWorkspace = result.workspace
+      }
+    }
+    return result
+  }
+
+  async doctor(options = {}) {
+    const report = {
+      schema: 'bailing.agent-client-doctor.v1',
+      ok: false,
+      checks: {
+        configuration: {
+          ok: this.connectionReady,
+          invalid: this.connectionReady ? [] : [...this.config.invalid, 'selectedConnection'],
+        },
+        dsh_host: cloneJson(this.hostContract),
+        sdk: { ok: false },
+        agent_session: { ok: false, state: 'not_checked', skipped: true },
+        workspace: { ok: false, state: 'not_checked', skipped: true },
+      },
+      next_action: '',
+    }
+    const finish = (nextAction) => sanitizePublicValue({
+      ...report,
+      ok: Object.values(report.checks).every((check) => check.ok === true),
+      next_action: nextAction,
+    })
+
+    if (!this.hostContract.ok) {
+      return finish('Use a DSH release whose host lifecycle matches the documented compatibility matrix.')
+    }
+    if (!this.connectionReady) {
+      return finish('Set the four public connection fields, reload the DSH profile, and run doctor again.')
+    }
+
+    let transport
+    try {
+      transport = await this.getTransport()
+      report.checks.sdk = { ok: true }
+    } catch {
+      return finish('Reinstall this plugin so its exact Agent Client SDK dependency can resolve.')
+    }
+
+    let status
+    try {
+      status = sanitizePublicValue(await transport.status({
+        connectionName: options.connectionName ?? this.defaultConnectionName,
+      }))
+    } catch {
+      report.checks.agent_session = {
+        ok: false,
+        state: 'unreachable',
+      }
+      return finish('Check Hub reachability, then run doctor again; no business action was attempted.')
+    }
+
+    const authorizationState = typeof status?.state === 'string' ? status.state : 'unknown'
+    const authorized = authorizationState === 'authorized'
+    report.checks.agent_session = {
+      ok: authorized,
+      state: authorizationState,
+    }
+    if (!authorized) {
+      return finish('Run /bailinghub login to authorize this Hub/client/workspace connection.')
+    }
+
+    try {
+      const result = sanitizePublicValue(await transport.workspaces({
+        connectionName: options.connectionName ?? this.defaultConnectionName,
+      }))
+      const workspaces = Array.isArray(result?.workspaces) ? result.workspaces : []
+      const configuredAuthorized = workspaces.some((entry) => entry?.route === this.defaultWorkspace)
+      const selectedMatches = status?.workspace === this.defaultWorkspace
+      report.checks.workspace = {
+        ok: configuredAuthorized && selectedMatches,
+        state: configuredAuthorized && selectedMatches ? 'authorized' : 'mismatch',
+        authorized_count: workspaces.length,
+      }
+    } catch {
+      report.checks.workspace = {
+        ok: false,
+        state: 'unreachable',
+      }
+      return finish('Check Agent API reachability and the current authorization, then run doctor again.')
+    }
+
+    if (!report.checks.workspace.ok) {
+      return finish('Authorize the configured workspace; use a dedicated client app or workspace when credential isolation is required.')
+    }
+    return finish('Open a new conversation in Native Tool Mode and run a read-only acceptance request.')
   }
 
   async status(options = {}) {
-    if (!this.config.valid) {
-      return { state: 'unconfigured', missing: [...this.config.invalid] }
+    if (!this.connectionReady) {
+      return { state: 'unconfigured', missing: [...this.config.invalid, 'selectedConnection'] }
     }
     return this.callConnection('status', {
-      connectionName: options.connectionName ?? this.config.connectionName,
+      connectionName: options.connectionName ?? this.defaultConnectionName,
     })
   }
 
   async logout(options = {}) {
     return this.callConnection('logout', {
-      connectionName: options.connectionName ?? this.config.connectionName,
+      connectionName: options.connectionName ?? this.defaultConnectionName,
     })
   }
 
   async workspaces(options = {}) {
     return this.callConnection('workspaces', {
-      connectionName: options.connectionName ?? this.config.connectionName,
+      connectionName: options.connectionName ?? this.defaultConnectionName,
     })
   }
 
@@ -1281,7 +1614,7 @@ export class BailingHubAgentClientRuntime {
         'Finish active BailingHub runs and sync pending completions before switching workspace',
       )
     }
-    const connectionName = options.connectionName ?? this.config.connectionName
+    const connectionName = options.connectionName ?? this.defaultConnectionName
     const result = await this.callConnection('use', {
       workspace: selected,
       route: selected,
@@ -1291,6 +1624,69 @@ export class BailingHubAgentClientRuntime {
     return result
   }
 
+  async connectionsList() {
+    return this.callConnection('connectionsList', {})
+  }
+
+  async connectionsAdd(input) {
+    const result = await this.callConnection('connectionsAdd', input)
+    const selected = result?.connection
+    if (selected?.connectionName && selected?.workspace) {
+      this.defaultConnectionName = selected.connectionName
+      this.defaultWorkspace = selected.workspace
+      this.defaultHubUrl = selected.hubUrl
+      this.defaultClientAppId = selected.clientAppId
+      this.connectionReady = true
+    }
+    return result
+  }
+
+  async connectionsUse(selector) {
+    const connectionName = String(selector ?? '').trim()
+    if (!connectionName) throw new TypeError('connection name is required')
+    const result = await this.callTransport('connectionsUse', [connectionName])
+    const selected = result?.connection
+    if (!selected?.connectionName || !selected?.hubUrl || !selected?.clientAppId || !selected?.workspace) {
+      throw new TypeError('The selected BailingHub connection metadata is incomplete')
+    }
+    this.defaultConnectionName = selected.connectionName
+    this.defaultWorkspace = selected.workspace
+    this.defaultHubUrl = selected.hubUrl
+    this.defaultClientAppId = selected.clientAppId
+    this.connectionReady = true
+    return result
+  }
+
+  async connectionsRemove(selector) {
+    const connectionName = String(selector ?? '').trim()
+    if (!connectionName) throw new TypeError('connection name is required')
+    const hasBlockingRun = [...this.states].some((state) =>
+      [...state.runs.values()].some((run) =>
+        run.status === 'active' ||
+        run.status === 'completing' ||
+        run.completion?.state === 'pending' ||
+        run.completion?.state === 'syncing',
+      ),
+    )
+    if (hasBlockingRun) {
+      throw new Error(
+        'Finish active BailingHub runs and sync pending completions before removing a connection',
+      )
+    }
+    const result = await this.callTransport('connectionsRemove', [connectionName])
+    const removedDefault = [result?.connectionName, result?.connectionKey]
+      .some((value) => typeof value === 'string' && value.trim() === this.defaultConnectionName)
+    try {
+      const registry = await this.connectionsList()
+      const selected = currentConnectionDefaults(registry)
+      if (selected) this.applyConnectionDefaults(selected)
+      else if (connectionRegistryIsEmpty(registry) || removedDefault) this.connectionReady = false
+    } catch {
+      if (removedDefault || result?.currentConnectionKey === null) this.connectionReady = false
+    }
+    return result
+  }
+
   async searchCapabilities(query, options = {}) {
     return this.callTransport('searchCapabilities', [
       {
@@ -1300,7 +1696,7 @@ export class BailingHubAgentClientRuntime {
       },
       {
         workspace: options.workspace ?? this.defaultWorkspace,
-        connectionName: options.connectionName ?? this.config.connectionName,
+        connectionName: options.connectionName ?? this.defaultConnectionName,
         signal: options.signal,
       },
     ])
@@ -1319,7 +1715,7 @@ export class BailingHubAgentClientRuntime {
           {},
           {
             workspace: options.workspace ?? this.defaultWorkspace,
-            connectionName: options.connectionName ?? this.config.connectionName,
+            connectionName: options.connectionName ?? this.defaultConnectionName,
             signal: options.signal,
           },
         ),

package/lib/transport.js

@@ -1,6 +1,10 @@
 const DEFAULT_SDK_MODULE = 'bailinghub-mcp-server/sdk'
 
 const REQUIRED_METHODS = [
+  'connectionsList',
+  'connectionsAdd',
+  'connectionsUse',
+  'connectionsRemove',
   'login',
   'status',
   'logout',
@@ -45,7 +49,7 @@ function resolveSdkFactory(module) {
  * Lazily resolves the generic BailingHub Agent Client SDK. The SDK, rather than
  * this DSH adapter, owns browser authorization, token storage, refresh, and the
  * HTTP endpoint mapping. A missing SDK therefore degrades only the first use;
- * it never prevents Cordis from loading the plugin candidate.
+ * it never prevents Cordis from loading the plugin.
  */
 export function createLazySdkTransport(config, options = {}) {
   const importModule = options.importModule ?? ((specifier) => import(specifier))

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-bailinghub",
-  "version": "0.2.0",
-  "description": "Native DeepSeek Harness adapter for the BailingHub Agent Client Core.",
+  "version": "0.3.0",
+  "description": "Let a local DeepSeek Harness Agent use BailingHub to query data, update records, and run permitted actions in your online store, SaaS, or other admin system.",
   "license": "MIT",
   "type": "module",
   "main": "lib/index.js",
@@ -39,6 +39,8 @@
     "cordis.agent-client.patch.yml",
     "cordis.patch.yml",
     "docs/AGENT_CLIENT_CONTRACT.md",
+    "docs/GETTING_STARTED.md",
+    "docs/GETTING_STARTED.zh-CN.md",
     "docs/MIGRATION_VNEXT.md",
     "docs/README.zh-CN.md",
     "SECURITY.md",
@@ -52,14 +54,22 @@
   },
   "scripts": {
     "check:project": "node scripts/check-project.mjs",
+    "check:marketplace": "node scripts/check-marketplace.mjs",
     "check:release-tag": "node scripts/check-release-tag.mjs",
     "test": "node --test tests/*.test.mjs",
-    "verify": "npm run check:project && npm test",
+    "verify": "npm run check:project && npm run check:marketplace && npm test",
     "prepack": "npm run verify"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "bailinghub-mcp-server": "0.2.0"
+    "bailinghub-mcp-server": "0.3.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-commands": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-scope": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.1-rc.2"
   },
   "dsh": {
     "bundle": {