dsh-bailinghub 0.7.0 → 0.8.0

package/lib/tool-guidance.js

@@ -0,0 +1,27 @@
+import { Buffer } from 'node:buffer'
+import { declarationKey } from './authorizations.js'
+
+const invalid = () => Object.assign(new Error('Tool guidance does not match the current authorized declaration'), { publicCode: 'agent_invalid_response' })
+
+/** Custom transports need the same bounded reference and binding checks as the SDK. */
+export function normalizeToolGuidance(value, { route, capabilityRevision, tool, normalizeSearch }) {
+  try {
+    if (!value || value.schema_version !== 'bailing.agent-tool-detail.v1' || value.route !== route ||
+      value.capability_revision !== capabilityRevision || value.tool?.name !== tool.name) throw invalid()
+    const normalized = normalizeSearch({ schema_version: 'bailing.agent-capability-search.v1',
+      capability_revision: capabilityRevision, tools: [value.tool] }).tools[0]
+    if (declarationKey(normalized) !== declarationKey(tool)) throw invalid()
+    const guidance = value.usage_guidance
+    if (!guidance || typeof guidance.text !== 'string' || /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/.test(guidance.text) ||
+      typeof guidance.truncated !== 'boolean' || guidance.max_chars !== 32768 || guidance.max_bytes !== 65536 ||
+      !Number.isSafeInteger(guidance.source_chars) || !Number.isSafeInteger(guidance.source_bytes)) throw invalid()
+    const chars = [...guidance.text].length
+    const bytes = Buffer.byteLength(guidance.text, 'utf8')
+    if (chars > guidance.max_chars || bytes > guidance.max_bytes || guidance.source_chars < chars || guidance.source_bytes < bytes ||
+      guidance.truncated !== (guidance.source_chars > chars || guidance.source_bytes > bytes)) throw invalid()
+    return { text: guidance.text, truncated: guidance.truncated, source_chars: guidance.source_chars,
+      max_chars: guidance.max_chars, source_bytes: guidance.source_bytes, max_bytes: guidance.max_bytes }
+  } catch {
+    throw invalid()
+  }
+}

package/lib/transport.js

@@ -102,6 +102,25 @@ export function createLazySdkTransport(config, options = {}) {
     }
     return sdk.getSystemInfo(...args)
   }
+  transport.getToolDetail = async (...args) => {
+    const sdk = await client()
+    if (typeof sdk.getToolDetail !== 'function') {
+      throw Object.assign(new Error('The installed SDK does not support tool guidance details'), { publicCode: 'agent_schema_unsupported' })
+    }
+    return sdk.getToolDetail(...args)
+  }
+  transport.getKnowledgeCapabilities = async (...args) => {
+    const sdk = await client()
+    return typeof sdk.getKnowledgeCapabilities === 'function' ? sdk.getKnowledgeCapabilities(...args) : {
+      schema_version: 'bailing.agent-knowledge-capabilities.v1', protocol: 'bailing.agent-knowledge.v1',
+      supported: false, route: args[0]?.workspace ?? config.workspace,
+    }
+  }
+  for (const method of ['searchKnowledge', 'readKnowledge']) transport[method] = async (...args) => {
+    const sdk = await client()
+    if (typeof sdk[method] !== 'function') throw Object.assign(new Error('The installed SDK does not support knowledge search/read'), { publicCode: 'agent_schema_unsupported' })
+    return sdk[method](...args)
+  }
   for (const method of ['uploadArtifact', 'getArtifact']) {
     transport[method] = async (...args) => {
       const sdk = await client()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-bailinghub",
-  "version": "0.7.0",
+  "version": "0.8.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",
@@ -63,7 +63,13 @@
     "docs/RELEASE_NOTES_v0.7.0.md",
     "docs/RELEASE_NOTES_v0.7.0.en.md",
     "docs/UPGRADE_v0.7.0.md",
-    "docs/UPGRADE_v0.7.0.en.md"
+    "docs/UPGRADE_v0.7.0.en.md",
+    "docs/CONTEXT_DELIVERY.md",
+    "docs/AGENT_KNOWLEDGE.md",
+    "docs/RELEASE_NOTES_v0.8.0.md",
+    "docs/RELEASE_NOTES_v0.8.0.en.md",
+    "docs/UPGRADE_v0.8.0.md",
+    "docs/UPGRADE_v0.8.0.en.md"
   ],
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
@@ -78,7 +84,7 @@
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "bailinghub-mcp-server": "0.7.0"
+    "bailinghub-mcp-server": "0.8.0"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",
@@ -92,5 +98,11 @@
     "bundle": {
       "patch": "./cordis.agent-client.patch.yml"
     }
+  },
+  "overrides": {
+    "bailinghub-mcp-server": {
+      "@modelcontextprotocol/sdk": "1.32.1"
+    },
+    "@hono/node-server": "2.0.12"
   }
 }