@xdxer/dingtalk-agent 0.1.4-beta.10 → 0.1.4-beta.12

package/dist/src/agent-platform.js

@@ -0,0 +1,202 @@
+// Managed Agent Platform 注册表与工作区归属解析。
+//
+// 一个 Agent 工作区归属于至多一个托管平台；归属解析顺序固定：
+//   DTA_AGENT_PLATFORM 环境变量 > dingtalk-agent.json#agentPlatform
+//   > .dingtalk-agent/agent-platform.json > 按 Provider 声明推断。
+// 平台相关的方法学不写进 CLI——它们随对应平台的 Skill 包分发，只在用户选择该平台时安装。
+// 平台命令（如 deploy/promote/observe）必须先通过归属门禁；coming-soon 平台一律 fail-closed。
+import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, parse, resolve } from 'node:path';
+import { findAgentProjectRoot } from './development-workspace.js';
+import { findExecutable } from './doctor.js';
+import { installGlobalSkill } from './skill-manager.js';
+export const MANAGED_AGENT_PLATFORMS = [
+    {
+        name: 'multica-dingtalk',
+        label: 'Multica (DingTalk)',
+        status: 'supported',
+        description: '钉钉 Multica 托管平台：供给、部署、钉钉机器人绑定、观测与调度。',
+        skills: ['dingtalk-agent-deploy', 'dingtalk-agent-boot-multica', 'multica-fde-external'],
+        commands: ['deploy', 'promote', 'observe'],
+    },
+    {
+        name: 'deap',
+        label: 'DEAP',
+        status: 'coming-soon',
+        description: '敬请期待。',
+        skills: [],
+        commands: [],
+    },
+];
+export const AGENT_PLATFORM_FILE = '.dingtalk-agent/agent-platform.json';
+const PROJECT_FILE = 'dingtalk-agent.json';
+export function agentPlatformDefinition(name) {
+    return MANAGED_AGENT_PLATFORMS.find((item) => item.name === name) || null;
+}
+export function resolveAgentPlatform(start = process.cwd(), env = process.env) {
+    const fromEnv = String(env.DTA_AGENT_PLATFORM || '').trim();
+    if (fromEnv)
+        return resolution(fromEnv, 'env', '');
+    const projectRoot = findAgentProjectRoot(start);
+    if (projectRoot) {
+        const manifestPath = join(projectRoot, PROJECT_FILE);
+        if (existsSync(manifestPath) && !lstatSync(manifestPath).isSymbolicLink()) {
+            const manifest = readJsonOrNull(manifestPath);
+            const declared = typeof manifest?.agentPlatform === 'string' ? manifest.agentPlatform.trim() : '';
+            if (declared)
+                return resolution(declared, 'project-manifest', manifestPath);
+        }
+    }
+    const platformPath = findUp(start, AGENT_PLATFORM_FILE);
+    if (platformPath) {
+        const stored = readJsonOrNull(platformPath);
+        const declared = typeof stored?.agentPlatform === 'string' ? stored.agentPlatform.trim() : '';
+        if (declared)
+            return resolution(declared, 'platform-file', platformPath);
+    }
+    if (projectRoot) {
+        const manifest = readJsonOrNull(join(projectRoot, PROJECT_FILE));
+        const providers = Object.values(manifest?.workspaces || {})
+            .map((workspace) => workspace?.provider?.kind);
+        if (providers.includes('multica')) {
+            return resolution('multica-dingtalk', 'inferred', join(projectRoot, PROJECT_FILE));
+        }
+    }
+    return resolution(null, 'none', '');
+}
+export function useAgentPlatform(start, name, options) {
+    const definition = agentPlatformDefinition(name);
+    if (!definition) {
+        throw new Error(`未知 managed agent platform: ${name}\n` +
+            `可用: ${MANAGED_AGENT_PLATFORMS.map((item) => `${item.name}（${statusLabel(item.status)}）`).join('、')}`);
+    }
+    if (definition.status !== 'supported') {
+        throw new Error(`${definition.label} 敬请期待——当前版本尚未开放该平台。`);
+    }
+    const projectRoot = findAgentProjectRoot(start);
+    let written;
+    if (projectRoot && existsSync(join(projectRoot, PROJECT_FILE))) {
+        const manifestPath = join(projectRoot, PROJECT_FILE);
+        if (lstatSync(manifestPath).isSymbolicLink()) {
+            throw new Error(`${PROJECT_FILE} 不能是符号链接`);
+        }
+        const manifest = readJsonOrNull(manifestPath);
+        if (!manifest || typeof manifest !== 'object') {
+            throw new Error(`${PROJECT_FILE} 不是合法 JSON，无法写入 agentPlatform 归属`);
+        }
+        manifest.agentPlatform = definition.name;
+        writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+        written = manifestPath;
+    }
+    else {
+        const target = join(resolve(start), AGENT_PLATFORM_FILE);
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, JSON.stringify({ $schema: 'dingtalk-agent/agent-platform@1', agentPlatform: definition.name }, null, 2) + '\n');
+        written = target;
+    }
+    const skillInstalls = [];
+    if (options.installSkills !== false) {
+        for (const skill of definition.skills) {
+            skillInstalls.push(installGlobalSkill(options.packageRoot, {
+                name: skill, home: options.home, env: options.env,
+            }));
+        }
+    }
+    return { ...resolveAgentPlatform(start, options.env || process.env), written, skillInstalls };
+}
+/** deploy/promote/observe 等平台命令的归属门禁：未归属、未知或 coming-soon 一律 fail-closed。 */
+export function requireSupportedAgentPlatform(command, start = process.cwd(), env = process.env) {
+    const resolved = resolveAgentPlatform(start, env);
+    if (!resolved.platform) {
+        throw new Error(`当前工作区未声明 managed agent platform，无法执行 \`${command}\`。\n` +
+            '先运行 `dta agent-platform use multica-dingtalk`，或设置 DTA_AGENT_PLATFORM 环境变量。');
+    }
+    if (!resolved.definition) {
+        throw new Error(`工作区声明了未知 platform: ${resolved.platform}（来源 ${resolved.source}）。\n` +
+            `可用: ${MANAGED_AGENT_PLATFORMS.map((item) => item.name).join('、')}`);
+    }
+    if (resolved.definition.status !== 'supported') {
+        throw new Error(`${resolved.definition.label} 敬请期待——\`${command}\` 尚未在该平台开放。`);
+    }
+    if (!resolved.definition.commands.includes(command)) {
+        throw new Error(`${resolved.definition.label} 不承接命令 \`${command}\`。`);
+    }
+    return resolved;
+}
+export function statusLabel(status) {
+    return status === 'supported' ? '已支持' : '敬请期待';
+}
+/**
+ * 平台工具链就绪检查（只读，不阻断）：选择/查看平台归属时提示用户缺什么、怎么补。
+ * 强制门禁仍由 requireSupportedAgentPlatform 与各平台命令自身承担。
+ */
+export function agentPlatformReadiness(name, env = process.env, home = homedir()) {
+    if (name !== 'multica-dingtalk')
+        return [];
+    const checks = [];
+    const cli = findExecutable('multica', env);
+    checks.push(cli
+        ? { id: 'multica-cli', ok: true, summary: `multica CLI 已安装（${cli}）` }
+        : {
+            id: 'multica-cli', ok: false, summary: '未找到 multica CLI',
+            hint: '安装：curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash',
+        });
+    checks.push(hasMulticaToken(home)
+        ? { id: 'multica-login', ok: true, summary: 'Multica 已登录（本地存在 token）' }
+        : {
+            id: 'multica-login', ok: false, summary: 'Multica 尚未登录',
+            hint: '登录：multica login --server-url <endpoint>（预发环境为 https://pre-fde-workbench.dingtalk.com）',
+        });
+    if (['HTTPS_PROXY', 'https_proxy', 'ALL_PROXY', 'all_proxy'].some((key) => env[key])) {
+        checks.push({
+            id: 'proxy-env', ok: false, summary: '检测到代理环境变量，可能阻断 Multica 直连',
+            hint: '连接失败时用 env -u HTTPS_PROXY -u https_proxy -u ALL_PROXY -u all_proxy 运行 multica 与平台脚本',
+        });
+    }
+    return checks;
+}
+function hasMulticaToken(home) {
+    const candidates = [join(home, '.multica', 'config.json')];
+    try {
+        for (const entry of readdirSync(join(home, '.multica', 'profiles'))) {
+            candidates.push(join(home, '.multica', 'profiles', entry, 'config.json'));
+        }
+    }
+    catch { /* profiles 目录不存在 */ }
+    return candidates.some((path) => {
+        const config = readJsonOrNull(path);
+        return typeof config?.token === 'string' && config.token.trim().length > 0;
+    });
+}
+function resolution(name, source, file) {
+    return {
+        $schema: 'dingtalk-agent/agent-platform-resolution@1',
+        platform: name,
+        source,
+        file,
+        definition: name ? agentPlatformDefinition(name) : null,
+        platforms: MANAGED_AGENT_PLATFORMS,
+    };
+}
+function readJsonOrNull(path) {
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function findUp(start, relativePath) {
+    let dir = resolve(start);
+    while (true) {
+        const candidate = join(dir, relativePath);
+        if (existsSync(candidate) && !lstatSync(candidate).isSymbolicLink())
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir || dir === parse(dir).root)
+            return null;
+        dir = parent;
+    }
+}
+//# sourceMappingURL=agent-platform.js.map

package/dist/src/agent-platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-platform.js","sourceRoot":"","sources":["../../src/agent-platform.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,oCAAoC;AACpC,gEAAgE;AAChE,6DAA6D;AAC7D,oDAAoD;AACpD,wEAAwE;AAExE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACpG,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAA0B,MAAM,oBAAoB,CAAA;AAa/E,MAAM,CAAC,MAAM,uBAAuB,GAA8B;IAChE;QACE,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,oBAAoB;QAC3B,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,sCAAsC;QACnD,MAAM,EAAE,CAAC,uBAAuB,EAAE,6BAA6B,EAAE,sBAAsB,CAAC;QACxF,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;KAC3C;IACD;QACE,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,aAAa;QACrB,WAAW,EAAE,OAAO;QACpB,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE,EAAE;KACb;CACF,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,qCAAqC,CAAA;AACxE,MAAM,YAAY,GAAG,qBAAqB,CAAA;AAkB1C,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAA;AAC3E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,MAAyB,OAAO,CAAC,GAAG;IAE3D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC3D,IAAI,OAAO;QAAE,OAAO,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAA;IAElD,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAC/C,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;QACpD,IAAI,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;YAC1E,MAAM,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;YAC7C,MAAM,QAAQ,GAAG,OAAO,QAAQ,EAAE,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;YACjG,IAAI,QAAQ;gBAAE,OAAO,UAAU,CAAC,QAAQ,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAA;QAC7E,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAA;IACvD,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;QAC3C,MAAM,QAAQ,GAAG,OAAO,MAAM,EAAE,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7F,IAAI,QAAQ;YAAE,OAAO,UAAU,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,CAAC,CAAA;IAC1E,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAA;QAChE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC;aACxD,GAAG,CAAC,CAAC,SAAc,EAAE,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;QACrD,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,OAAO,UAAU,CAAC,kBAAkB,EAAE,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAA;QACpF,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;AACrC,CAAC;AASD,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EAAE,IAAY,EAAE,OAAgC;IAE7D,MAAM,UAAU,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAChD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,IAAI;YACtC,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACtG,CAAA;IACH,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,qBAAqB,CAAC,CAAA;IAC3D,CAAC;IAED,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAC/C,IAAI,OAAe,CAAA;IACnB,IAAI,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;QAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;QACpD,IAAI,SAAS,CAAC,YAAY,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,UAAU,CAAC,CAAA;QAC5C,CAAC;QACD,MAAM,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;QAC7C,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,kCAAkC,CAAC,CAAA;QACpE,CAAC;QACD,QAAQ,CAAC,aAAa,GAAG,UAAU,CAAC,IAAI,CAAA;QACxC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;QACrE,OAAO,GAAG,YAAY,CAAA;IACxB,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC,CAAA;QACxD,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/C,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAClC,EAAE,OAAO,EAAE,iCAAiC,EAAE,aAAa,EAAE,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CACxF,GAAG,IAAI,CAAC,CAAA;QACT,OAAO,GAAG,MAAM,CAAA;IAClB,CAAC;IAED,MAAM,aAAa,GAAwB,EAAE,CAAA;IAC7C,IAAI,OAAO,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtC,aAAa,CAAC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE;gBACzD,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG;aAClD,CAAC,CAAC,CAAA;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAA;AAC/F,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,6BAA6B,CAC3C,OAAe,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,MAAyB,OAAO,CAAC,GAAG;IAE5E,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IACjD,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,0CAA0C,OAAO,OAAO;YACxD,4EAA4E,CAC7E,CAAA;IACH,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,sBAAsB,QAAQ,CAAC,QAAQ,OAAO,QAAQ,CAAC,MAAM,MAAM;YACnE,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACpE,CAAA;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,YAAY,OAAO,cAAc,CAAC,CAAA;IAChF,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,YAAY,OAAO,KAAK,CAAC,CAAA;IACvE,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAA2B;IACrD,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;AAChD,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAY,EAAE,MAAyB,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,EAAE;IAEpE,IAAI,IAAI,KAAK,kBAAkB;QAAE,OAAO,EAAE,CAAA;IAC1C,MAAM,MAAM,GAAkC,EAAE,CAAA;IAChD,MAAM,GAAG,GAAG,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IAC1C,MAAM,CAAC,IAAI,CAAC,GAAG;QACb,CAAC,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,GAAG,GAAG,EAAE;QACrE,CAAC,CAAC;YACE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB;YACxD,IAAI,EAAE,mGAAmG;SAC1G,CAAC,CAAA;IACN,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QAC/B,CAAC,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,yBAAyB,EAAE;QACvE,CAAC,CAAC;YACE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc;YACvD,IAAI,EAAE,wFAAwF;SAC/F,CAAC,CAAA;IACN,IAAI,CAAC,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACrF,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,2BAA2B;YAChE,IAAI,EAAE,qFAAqF;SAC5F,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAA;IAC1D,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;YACpE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAA;QAC3E,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAChC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QACnC,OAAO,OAAO,MAAM,EAAE,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,IAAmB,EAAE,MAA2B,EAAE,IAAY;IAE9D,OAAO;QACL,OAAO,EAAE,4CAA4C;QACrD,QAAQ,EAAE,IAAI;QACd,MAAM;QACN,IAAI;QACJ,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QACvD,SAAS,EAAE,uBAAuB;KACnC,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAA;IAAC,CAAC;AAC7E,CAAC;AAED,SAAS,MAAM,CAAC,KAAa,EAAE,YAAoB;IACjD,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACxB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;QACzC,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE;YAAE,OAAO,SAAS,CAAA;QACrF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI;YAAE,OAAO,IAAI,CAAA;QAC1D,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC","sourcesContent":["// Managed Agent Platform 注册表与工作区归属解析。\n//\n// 一个 Agent 工作区归属于至多一个托管平台；归属解析顺序固定：\n//   DTA_AGENT_PLATFORM 环境变量 > dingtalk-agent.json#agentPlatform\n//   > .dingtalk-agent/agent-platform.json > 按 Provider 声明推断。\n// 平台相关的方法学不写进 CLI——它们随对应平台的 Skill 包分发，只在用户选择该平台时安装。\n// 平台命令（如 deploy/promote/observe）必须先通过归属门禁；coming-soon 平台一律 fail-closed。\n\nimport { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { dirname, join, parse, resolve } from 'node:path'\n\nimport { findAgentProjectRoot } from './development-workspace.js'\nimport { findExecutable } from './doctor.js'\nimport { installGlobalSkill, type GlobalSkillStatus } from './skill-manager.js'\n\nexport type AgentPlatformStatus = 'supported' | 'coming-soon'\n\nexport interface AgentPlatformDefinition {\n  name: string\n  label: string\n  status: AgentPlatformStatus\n  description: string\n  skills: string[]\n  commands: string[]\n}\n\nexport const MANAGED_AGENT_PLATFORMS: AgentPlatformDefinition[] = [\n  {\n    name: 'multica-dingtalk',\n    label: 'Multica (DingTalk)',\n    status: 'supported',\n    description: '钉钉 Multica 托管平台：供给、部署、钉钉机器人绑定、观测与调度。',\n    skills: ['dingtalk-agent-deploy', 'dingtalk-agent-boot-multica', 'multica-fde-external'],\n    commands: ['deploy', 'promote', 'observe'],\n  },\n  {\n    name: 'deap',\n    label: 'DEAP',\n    status: 'coming-soon',\n    description: '敬请期待。',\n    skills: [],\n    commands: [],\n  },\n]\n\nexport const AGENT_PLATFORM_FILE = '.dingtalk-agent/agent-platform.json'\nconst PROJECT_FILE = 'dingtalk-agent.json'\n\nexport type AgentPlatformSource = 'env' | 'project-manifest' | 'platform-file' | 'inferred' | 'none'\n\nexport interface AgentPlatformResolution {\n  $schema: 'dingtalk-agent/agent-platform-resolution@1'\n  platform: string | null\n  source: AgentPlatformSource\n  file: string\n  definition: AgentPlatformDefinition | null\n  platforms: AgentPlatformDefinition[]\n}\n\nexport interface AgentPlatformUseResult extends AgentPlatformResolution {\n  written: string\n  skillInstalls: GlobalSkillStatus[]\n}\n\nexport function agentPlatformDefinition(name: string): AgentPlatformDefinition | null {\n  return MANAGED_AGENT_PLATFORMS.find((item) => item.name === name) || null\n}\n\nexport function resolveAgentPlatform(\n  start = process.cwd(), env: NodeJS.ProcessEnv = process.env,\n): AgentPlatformResolution {\n  const fromEnv = String(env.DTA_AGENT_PLATFORM || '').trim()\n  if (fromEnv) return resolution(fromEnv, 'env', '')\n\n  const projectRoot = findAgentProjectRoot(start)\n  if (projectRoot) {\n    const manifestPath = join(projectRoot, PROJECT_FILE)\n    if (existsSync(manifestPath) && !lstatSync(manifestPath).isSymbolicLink()) {\n      const manifest = readJsonOrNull(manifestPath)\n      const declared = typeof manifest?.agentPlatform === 'string' ? manifest.agentPlatform.trim() : ''\n      if (declared) return resolution(declared, 'project-manifest', manifestPath)\n    }\n  }\n\n  const platformPath = findUp(start, AGENT_PLATFORM_FILE)\n  if (platformPath) {\n    const stored = readJsonOrNull(platformPath)\n    const declared = typeof stored?.agentPlatform === 'string' ? stored.agentPlatform.trim() : ''\n    if (declared) return resolution(declared, 'platform-file', platformPath)\n  }\n\n  if (projectRoot) {\n    const manifest = readJsonOrNull(join(projectRoot, PROJECT_FILE))\n    const providers = Object.values(manifest?.workspaces || {})\n      .map((workspace: any) => workspace?.provider?.kind)\n    if (providers.includes('multica')) {\n      return resolution('multica-dingtalk', 'inferred', join(projectRoot, PROJECT_FILE))\n    }\n  }\n\n  return resolution(null, 'none', '')\n}\n\nexport interface AgentPlatformUseOptions {\n  packageRoot: string\n  home?: string\n  env?: NodeJS.ProcessEnv\n  installSkills?: boolean\n}\n\nexport function useAgentPlatform(\n  start: string, name: string, options: AgentPlatformUseOptions,\n): AgentPlatformUseResult {\n  const definition = agentPlatformDefinition(name)\n  if (!definition) {\n    throw new Error(\n      `未知 managed agent platform: ${name}\\n` +\n      `可用: ${MANAGED_AGENT_PLATFORMS.map((item) => `${item.name}（${statusLabel(item.status)}）`).join('、')}`,\n    )\n  }\n  if (definition.status !== 'supported') {\n    throw new Error(`${definition.label} 敬请期待——当前版本尚未开放该平台。`)\n  }\n\n  const projectRoot = findAgentProjectRoot(start)\n  let written: string\n  if (projectRoot && existsSync(join(projectRoot, PROJECT_FILE))) {\n    const manifestPath = join(projectRoot, PROJECT_FILE)\n    if (lstatSync(manifestPath).isSymbolicLink()) {\n      throw new Error(`${PROJECT_FILE} 不能是符号链接`)\n    }\n    const manifest = readJsonOrNull(manifestPath)\n    if (!manifest || typeof manifest !== 'object') {\n      throw new Error(`${PROJECT_FILE} 不是合法 JSON，无法写入 agentPlatform 归属`)\n    }\n    manifest.agentPlatform = definition.name\n    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\\n')\n    written = manifestPath\n  } else {\n    const target = join(resolve(start), AGENT_PLATFORM_FILE)\n    mkdirSync(dirname(target), { recursive: true })\n    writeFileSync(target, JSON.stringify(\n      { $schema: 'dingtalk-agent/agent-platform@1', agentPlatform: definition.name }, null, 2,\n    ) + '\\n')\n    written = target\n  }\n\n  const skillInstalls: GlobalSkillStatus[] = []\n  if (options.installSkills !== false) {\n    for (const skill of definition.skills) {\n      skillInstalls.push(installGlobalSkill(options.packageRoot, {\n        name: skill, home: options.home, env: options.env,\n      }))\n    }\n  }\n\n  return { ...resolveAgentPlatform(start, options.env || process.env), written, skillInstalls }\n}\n\n/** deploy/promote/observe 等平台命令的归属门禁：未归属、未知或 coming-soon 一律 fail-closed。 */\nexport function requireSupportedAgentPlatform(\n  command: string, start = process.cwd(), env: NodeJS.ProcessEnv = process.env,\n): AgentPlatformResolution {\n  const resolved = resolveAgentPlatform(start, env)\n  if (!resolved.platform) {\n    throw new Error(\n      `当前工作区未声明 managed agent platform，无法执行 \\`${command}\\`。\\n` +\n      '先运行 `dta agent-platform use multica-dingtalk`，或设置 DTA_AGENT_PLATFORM 环境变量。',\n    )\n  }\n  if (!resolved.definition) {\n    throw new Error(\n      `工作区声明了未知 platform: ${resolved.platform}（来源 ${resolved.source}）。\\n` +\n      `可用: ${MANAGED_AGENT_PLATFORMS.map((item) => item.name).join('、')}`,\n    )\n  }\n  if (resolved.definition.status !== 'supported') {\n    throw new Error(`${resolved.definition.label} 敬请期待——\\`${command}\\` 尚未在该平台开放。`)\n  }\n  if (!resolved.definition.commands.includes(command)) {\n    throw new Error(`${resolved.definition.label} 不承接命令 \\`${command}\\`。`)\n  }\n  return resolved\n}\n\nexport function statusLabel(status: AgentPlatformStatus): string {\n  return status === 'supported' ? '已支持' : '敬请期待'\n}\n\nexport interface AgentPlatformReadinessCheck {\n  id: string\n  ok: boolean\n  summary: string\n  hint?: string\n}\n\n/**\n * 平台工具链就绪检查（只读，不阻断）：选择/查看平台归属时提示用户缺什么、怎么补。\n * 强制门禁仍由 requireSupportedAgentPlatform 与各平台命令自身承担。\n */\nexport function agentPlatformReadiness(\n  name: string, env: NodeJS.ProcessEnv = process.env, home = homedir(),\n): AgentPlatformReadinessCheck[] {\n  if (name !== 'multica-dingtalk') return []\n  const checks: AgentPlatformReadinessCheck[] = []\n  const cli = findExecutable('multica', env)\n  checks.push(cli\n    ? { id: 'multica-cli', ok: true, summary: `multica CLI 已安装（${cli}）` }\n    : {\n        id: 'multica-cli', ok: false, summary: '未找到 multica CLI',\n        hint: '安装：curl -fsSL https://raw.githubusercontent.com/multica-ai/multica/main/scripts/install.sh | bash',\n      })\n  checks.push(hasMulticaToken(home)\n    ? { id: 'multica-login', ok: true, summary: 'Multica 已登录（本地存在 token）' }\n    : {\n        id: 'multica-login', ok: false, summary: 'Multica 尚未登录',\n        hint: '登录：multica login --server-url <endpoint>（预发环境为 https://pre-fde-workbench.dingtalk.com）',\n      })\n  if (['HTTPS_PROXY', 'https_proxy', 'ALL_PROXY', 'all_proxy'].some((key) => env[key])) {\n    checks.push({\n      id: 'proxy-env', ok: false, summary: '检测到代理环境变量，可能阻断 Multica 直连',\n      hint: '连接失败时用 env -u HTTPS_PROXY -u https_proxy -u ALL_PROXY -u all_proxy 运行 multica 与平台脚本',\n    })\n  }\n  return checks\n}\n\nfunction hasMulticaToken(home: string): boolean {\n  const candidates = [join(home, '.multica', 'config.json')]\n  try {\n    for (const entry of readdirSync(join(home, '.multica', 'profiles'))) {\n      candidates.push(join(home, '.multica', 'profiles', entry, 'config.json'))\n    }\n  } catch { /* profiles 目录不存在 */ }\n  return candidates.some((path) => {\n    const config = readJsonOrNull(path)\n    return typeof config?.token === 'string' && config.token.trim().length > 0\n  })\n}\n\nfunction resolution(\n  name: string | null, source: AgentPlatformSource, file: string,\n): AgentPlatformResolution {\n  return {\n    $schema: 'dingtalk-agent/agent-platform-resolution@1',\n    platform: name,\n    source,\n    file,\n    definition: name ? agentPlatformDefinition(name) : null,\n    platforms: MANAGED_AGENT_PLATFORMS,\n  }\n}\n\nfunction readJsonOrNull(path: string): any {\n  try { return JSON.parse(readFileSync(path, 'utf8')) } catch { return null }\n}\n\nfunction findUp(start: string, relativePath: string): string | null {\n  let dir = resolve(start)\n  while (true) {\n    const candidate = join(dir, relativePath)\n    if (existsSync(candidate) && !lstatSync(candidate).isSymbolicLink()) return candidate\n    const parent = dirname(dir)\n    if (parent === dir || dir === parse(dir).root) return null\n    dir = parent\n  }\n}\n"]}

package/dist/src/development-workspace.js

@@ -10,6 +10,7 @@ export const CURRENT_WORKSPACE_FILE = '.dingtalk-agent/current-workspace';
 export const WORKSPACE_STATE_ROOT = '.dingtalk-agent/state/workspaces';
 export const LEGACY_WORKSPACE_NAME = 'legacy-prepared';
 const PROJECT_KEYS = new Set(['$schema', 'name', 'dtaVersion', 'agent', 'workspaces']);
+const PROJECT_OPTIONAL_KEYS = new Set([...PROJECT_KEYS, 'agentPlatform']);
 const AGENT_KEYS = new Set(['definition', 'skills']);
 const WORKSPACE_KEYS = new Set(['stage', 'provider', 'storage', 'authority']);
 const OPENCODE_KEYS = new Set(['kind', 'model']);
@@ -187,12 +188,17 @@ function loadAgentProject(start) {
 }
 function validateProjectManifest(value, root) {
     const input = objectValue(value, 'Project manifest');
-    assertExactKeys(input, PROJECT_KEYS, 'Project manifest');
+    assertAllowedKeys(input, PROJECT_OPTIONAL_KEYS, 'Project manifest');
+    const missing = [...PROJECT_KEYS].filter((key) => !(key in input));
+    if (missing.length)
+        throw new Error(`Project manifest 缺少字段: ${missing.join(', ')}`);
     if (input.$schema !== 'dingtalk-agent/project@1') {
         throw new Error('Project manifest 缺少 dingtalk-agent/project@1 schema');
     }
     const name = stableName(input.name, 'Project name');
     const dtaVersion = requiredString(input.dtaVersion, 'dtaVersion');
+    const agentPlatform = input.agentPlatform === undefined
+        ? undefined : requiredString(input.agentPlatform, 'agentPlatform');
     const agentInput = objectValue(input.agent, 'Project agent');
     assertExactKeys(agentInput, AGENT_KEYS, 'Project agent');
     const definition = safeRelativePath(root, requiredString(agentInput.definition, 'agent.definition'), 'agent.definition', false);
@@ -216,6 +222,7 @@ function validateProjectManifest(value, root) {
     }
     return {
         $schema: 'dingtalk-agent/project@1', name, dtaVersion,
+        ...(agentPlatform === undefined ? {} : { agentPlatform }),
         agent: { definition, skills }, workspaces,
     };
 }