@xdxer/dingtalk-agent 0.1.4-beta.13 → 0.1.4-beta.15

package/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 All notable changes to `@xdxer/dingtalk-agent` are documented here. The project follows semantic versioning; prerelease entries describe release candidates and do not imply that Live canaries or registry publication have completed.
 
+## 0.1.4-beta.15 - 2026-07-19
+
+### Added
+
+- Multica endpoint resolution and display: `agent-platform show|use` now print the resolved endpoint and its source unconditionally — even when multica is not installed or logged in — so you always know where you'd connect and how to switch. `resolveEndpoint()` uses a single source of truth aligned with the executor (`multica_ext.py` reads `MULTICA_SERVER_URL`/`--profile`): `MULTICA_SERVER_URL` env > project config (`dingtalk-agent.json#multicaEndpoint` or `.dingtalk-agent/agent-platform.json.endpoint`) > exactly one logged-in profile's server_url (multiple = ambiguous, never auto-picked) > the platform's suggested endpoint (pre, flagged unconfirmed, never a silent direct-connect). The login readiness hint emits a full copyable `multica login --server-url <resolved> --token ...` with the source annotated.
+- The project manifest gains an optional `multicaEndpoint` field (schema + validation) for a persistent per-project endpoint override.
+
+### Changed
+
+- Scattered pre-fde endpoint literals in `PLATFORM.md` and the compose skill now point to `dta agent-platform show` as the single source instead of hardcoding the URL, so docs cannot drift from the resolver.
+
+### Release boundary
+
+- Distribution is limited to the public npm `beta` dist-tag, a Git tag, and a GitHub pre-release. The suggested endpoint is an explicitly-unconfirmed hint only; the executor stays fail-closed and deploy-time confirmation is unchanged. Live waivers from beta.9 remain unchanged.
+
+## 0.1.4-beta.14 - 2026-07-19
+
+### Added
+
+- Per-platform `PLATFORM.md`: switching to a platform now loads a document explaining what each bundled skill does. `agent-platform use|show` print the doc path, and `list|show` display every skill's role and purpose (the registry skill bindings gained a `purpose` field). `multica-dingtalk`'s doc covers the three skills by role, the delivery chain, readiness, the dws-first robot-binding priority (including `--allow-unbound` for connect-to-customers mode), DWS-conversation acceptance, and both unbind paths; `deap` is a coming-soon stub.
+
+### Fixed
+
+- `multica-external`'s `dingtalk-bind` now sends `robot_code` (defaulting to `client_id`, with a `--robot-code` flag). Manual robot binding previously failed with `400 robot_code is required`, blocking real DingTalk robot delivery; a live 10-chain regression on the pre environment now confirms real DWS→robot→agent replies.
+
+### Validated
+
+- End-to-end regression on the dedicated pre environment (authorized): from-zero token login, ten role-diverse agents each carrying basic-behavior (verified silent on un-@mentioned group messages), DWS-created robots bound via the dws path with credentials, and acceptance by real DWS conversation. Five robots were reused via revoke+rebind, confirming messages reroute to the newly bound agent. Both unbind APIs (robot `dingtalk-revoke`, account `dingtalk-account-unbind`) were confirmed.
+
+### Release boundary
+
+- Distribution is limited to the public npm `beta` dist-tag, a Git tag, and a GitHub pre-release. The regression's platform side effects (agents, robot bindings, messages) occurred only on the user-authorized pre environment with dedicated test objects. Live waivers from beta.9 remain unchanged.
+
 ## 0.1.4-beta.13 - 2026-07-19
 
 ### Changed

package/dist/bin/dingtalk-agent.js

@@ -39,7 +39,7 @@ import { checkpointTask, showTaskCheckpoint } from '../src/memory/task-checkpoin
 import { upsertOperationalMemory } from '../src/memory/operational.js';
 import { proposeMemoryCandidate, publishMemoryCandidate, reviewMemoryCandidate, showMemoryCandidate, } from '../src/memory/candidates.js';
 import { installBundledSkills, installGlobalSkill, skillStatus, skillSuiteStatus, uninstallBundledSkills, uninstallGlobalSkill, upgradeBundledSkills, upgradeGlobalSkill, } from '../src/skill-manager.js';
-import { agentPlatformReadiness, MANAGED_AGENT_PLATFORMS, multicaTargets, platformSkillForRole, requireSupportedAgentPlatform, resolveAgentPlatform, statusLabel as platformStatusLabel, useAgentPlatform, } from '../src/agent-platform.js';
+import { agentPlatformReadiness, MANAGED_AGENT_PLATFORMS, multicaTargets, platformDocPath, platformSkillForRole, requireSupportedAgentPlatform, resolveAgentPlatform, resolveEndpoint, statusLabel as platformStatusLabel, useAgentPlatform, } from '../src/agent-platform.js';
 const PACKAGE_ROOT = resolvePackageRoot(import.meta.url);
 const PACKAGE_JSON = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8'));
 // ROOT = **你的工作区**（当前目录），不是包所在的目录。
@@ -742,14 +742,18 @@ async function main() {
             if (positionals.length)
                 fail('agent-platform show 不接受位置参数');
             const out = resolveAgentPlatform(PROJECT_START);
-            const readiness = out.definition ? agentPlatformReadiness(out.definition.name) : [];
+            const readiness = out.definition ? agentPlatformReadiness(out.definition.name, process.env, undefined, PROJECT_START) : [];
             const targets = out.definition?.name === 'multica-dingtalk' ? multicaTargets() : [];
+            const endpoint = out.definition ? resolveEndpoint(out.definition.name, PROJECT_START) : null;
+            const doc = out.definition ? platformDocPath(PACKAGE_ROOT, out.definition.name) : null;
             if (o.json)
-                console.log(JSON.stringify({ ...out, readiness, targets }, null, 2));
+                console.log(JSON.stringify({ ...out, endpoint, readiness, targets, doc }, null, 2));
             else {
                 printAgentPlatformResolution(out);
+                printEndpoint(endpoint);
                 printAgentPlatformReadiness(readiness);
                 printMulticaTargets(targets);
+                printPlatformDoc(out.definition?.name);
             }
             return;
         }
@@ -759,10 +763,12 @@ async function main() {
             const out = useAgentPlatform(PROJECT_START, positionals[0], {
                 packageRoot: PACKAGE_ROOT, installSkills: !o['no-install'],
             });
-            const readiness = out.definition ? agentPlatformReadiness(out.definition.name) : [];
+            const readiness = out.definition ? agentPlatformReadiness(out.definition.name, process.env, undefined, PROJECT_START) : [];
             const targets = out.definition?.name === 'multica-dingtalk' ? multicaTargets() : [];
+            const endpoint = out.definition ? resolveEndpoint(out.definition.name, PROJECT_START) : null;
+            const doc = out.definition ? platformDocPath(PACKAGE_ROOT, out.definition.name) : null;
             if (o.json)
-                console.log(JSON.stringify({ ...out, readiness, targets }, null, 2));
+                console.log(JSON.stringify({ ...out, endpoint, readiness, targets, doc }, null, 2));
             else {
                 console.log(`✅ 工作区已归属 ${out.definition?.label}（写入 ${out.written}）`);
                 for (const install of out.skillInstalls)
@@ -772,8 +778,10 @@ async function main() {
                         ? `   已跳过平台技能包安装（--no-install）：${out.definition.skills.map((item) => item.name).join(', ')}`
                         : '   该平台无需额外技能包。');
                 }
+                printEndpoint(endpoint);
                 printAgentPlatformReadiness(readiness);
                 printMulticaTargets(targets);
+                printPlatformDoc(out.definition?.name);
             }
             return;
         }
@@ -1458,8 +1466,8 @@ function printAgentEnhance(out) {
 function printAgentPlatform(platform) {
     console.log(`${platform.status === 'supported' ? '✅' : '⏳'} ${platform.name} · ${platform.label} · ${platformStatusLabel(platform.status)}`);
     console.log(`   ${platform.description}`);
-    if (platform.skills.length)
-        console.log(`   技能包: ${platform.skills.map((item) => `${item.role}→${item.name}`).join(' · ')}`);
+    for (const skill of platform.skills)
+        console.log(`   技能[${skill.role}] ${skill.name} —— ${skill.purpose}`);
     if (platform.commands.length)
         console.log(`   平台命令: ${platform.commands.map((item) => `dta ${item}`).join(' · ')}`);
 }
@@ -1472,8 +1480,8 @@ function printAgentPlatformResolution(out) {
     const known = out.definition;
     console.log(`${known ? '✅' : '❌'} 当前 platform: ${out.platform}${known ? ` · ${known.label} · ${platformStatusLabel(known.status)}` : '（未知）'}`);
     console.log(`   来源: ${out.source}${out.file ? ` · ${out.file}` : ''}`);
-    if (known?.skills.length)
-        console.log(`   技能包: ${known.skills.map((item) => `${item.role}→${item.name}`).join(' · ')}`);
+    for (const skill of known?.skills || [])
+        console.log(`   技能[${skill.role}] ${skill.name} —— ${skill.purpose}`);
 }
 // 披露：dta 层平台命令关联到平台内确切的 Skill（诊断信息走 stderr，不污染 --json stdout）。
 function disclosePlatformSkill(resolution, role) {
@@ -1481,6 +1489,30 @@ function disclosePlatformSkill(resolution, role) {
     if (skillName)
         console.error(`提示: 平台 ${resolution.definition.name} 的该命令方法学由 Skill ${skillName} 承载`);
 }
+function printEndpoint(endpoint) {
+    if (!endpoint)
+        return;
+    if (endpoint.source === 'ambiguous') {
+        console.log(`   Endpoint: 多个已登录目标未选定（${endpoint.candidates.join(' / ')}）——` +
+            `用 ${endpoint.envVar} 或指定 profile 明确选择`);
+        return;
+    }
+    if (!endpoint.endpoint) {
+        console.log(`   Endpoint: 未解析——设 ${endpoint.envVar} 或登录 multica 后生效`);
+        return;
+    }
+    const mark = endpoint.confirmed ? '✅' : '⚠️';
+    const note = endpoint.confirmed ? '' : '（建议/未确认，deploy 前需显式确认是预发还是生产）';
+    console.log(`   ${mark} Endpoint: ${endpoint.endpoint} · 来源: ${endpoint.source}${note}`);
+    console.log(`   （切换：设 ${endpoint.envVar}=<url>、写 dingtalk-agent.json#multicaEndpoint、或登录对应 profile；无需改代码）`);
+}
+function printPlatformDoc(platformName) {
+    if (!platformName)
+        return;
+    const path = platformDocPath(PACKAGE_ROOT, platformName);
+    if (path)
+        console.log(`   平台说明: ${path}\n   （切换到该平台后请阅读，了解各技能用途与交付链）`);
+}
 function printMulticaTargets(targets) {
     if (!targets.length)
         return;