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

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 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

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, platformDocPath, 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,13 +742,15 @@ 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, doc }, 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);
@@ -761,11 +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, doc }, 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)
@@ -775,6 +778,7 @@ async function main() {
                         ? `   已跳过平台技能包安装（--no-install）：${out.definition.skills.map((item) => item.name).join(', ')}`
                         : '   该平台无需额外技能包。');
                 }
+                printEndpoint(endpoint);
                 printAgentPlatformReadiness(readiness);
                 printMulticaTargets(targets);
                 printPlatformDoc(out.definition?.name);
@@ -1485,6 +1489,23 @@ 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;