@xdxer/dingtalk-agent 0.1.4-beta.9 → 0.1.4

package/dist/src/map.js

@@ -0,0 +1,157 @@
+// Managed Agents Platform（MAP）注册表与工作区归属解析。
+//
+// 一个 Agent 工作区归属于至多一个托管平台；归属解析顺序固定：
+//   DTA_MAP 环境变量 > dingtalk-agent.json#map > .dingtalk-agent/map.json > 按 Provider 声明推断。
+// 平台相关的方法学不写进 CLI——它们随对应平台的 Skill 包分发，只在用户选择该平台时安装。
+// 平台命令（如 deploy/promote/observe）必须先通过归属门禁；coming-soon 平台一律 fail-closed。
+import { existsSync, lstatSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, parse, resolve } from 'node:path';
+import { findAgentProjectRoot } from './development-workspace.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'],
+        commands: ['deploy', 'promote', 'observe'],
+    },
+    {
+        name: 'deap',
+        label: 'DEAP',
+        status: 'coming-soon',
+        description: '敬请期待。',
+        skills: [],
+        commands: [],
+    },
+];
+export const MAP_FILE = '.dingtalk-agent/map.json';
+const PROJECT_FILE = 'dingtalk-agent.json';
+export function mapDefinition(name) {
+    return MANAGED_AGENT_PLATFORMS.find((item) => item.name === name) || null;
+}
+export function resolveMap(start = process.cwd(), env = process.env) {
+    const fromEnv = String(env.DTA_MAP || '').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?.map === 'string' ? manifest.map.trim() : '';
+            if (declared)
+                return resolution(declared, 'project-manifest', manifestPath);
+        }
+    }
+    const mapPath = findUp(start, MAP_FILE);
+    if (mapPath) {
+        const stored = readJsonOrNull(mapPath);
+        const declared = typeof stored?.map === 'string' ? stored.map.trim() : '';
+        if (declared)
+            return resolution(declared, 'map-file', mapPath);
+    }
+    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 useMap(start, name, options) {
+    const definition = mapDefinition(name);
+    if (!definition) {
+        throw new Error(`未知 managed agents 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，无法写入 map 归属`);
+        }
+        manifest.map = definition.name;
+        writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+        written = manifestPath;
+    }
+    else {
+        const target = join(resolve(start), MAP_FILE);
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, JSON.stringify({ $schema: 'dingtalk-agent/map@1', map: 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 { ...resolveMap(start, options.env || process.env), written, skillInstalls };
+}
+/** deploy/promote/observe 等平台命令的归属门禁：未归属、未知或 coming-soon 一律 fail-closed。 */
+export function requireSupportedMap(command, start = process.cwd(), env = process.env) {
+    const resolved = resolveMap(start, env);
+    if (!resolved.map) {
+        throw new Error(`当前工作区未声明 managed agents platform，无法执行 \`${command}\`。\n` +
+            '先运行 `dta map use multica-dingtalk`，或设置 DTA_MAP 环境变量。');
+    }
+    if (!resolved.definition) {
+        throw new Error(`工作区声明了未知 platform: ${resolved.map}（来源 ${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' ? '已支持' : '敬请期待';
+}
+function resolution(name, source, file) {
+    return {
+        $schema: 'dingtalk-agent/map-resolution@1',
+        map: name,
+        source,
+        file,
+        definition: name ? mapDefinition(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=map.js.map

package/dist/src/map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/map.ts"],"names":[],"mappings":"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","sourcesContent":["// Managed Agents Platform（MAP）注册表与工作区归属解析。\n//\n// 一个 Agent 工作区归属于至多一个托管平台；归属解析顺序固定：\n//   DTA_MAP 环境变量 > dingtalk-agent.json#map > .dingtalk-agent/map.json > 按 Provider 声明推断。\n// 平台相关的方法学不写进 CLI——它们随对应平台的 Skill 包分发，只在用户选择该平台时安装。\n// 平台命令（如 deploy/promote/observe）必须先通过归属门禁；coming-soon 平台一律 fail-closed。\n\nimport { existsSync, lstatSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport { dirname, join, parse, resolve } from 'node:path'\n\nimport { findAgentProjectRoot } from './development-workspace.js'\nimport { installGlobalSkill, type GlobalSkillStatus } from './skill-manager.js'\n\nexport type MapStatus = 'supported' | 'coming-soon'\n\nexport interface MapDefinition {\n  name: string\n  label: string\n  status: MapStatus\n  description: string\n  skills: string[]\n  commands: string[]\n}\n\nexport const MANAGED_AGENT_PLATFORMS: MapDefinition[] = [\n  {\n    name: 'multica-dingtalk',\n    label: 'Multica (DingTalk)',\n    status: 'supported',\n    description: '钉钉 Multica 托管平台：受控部署、晋级与观测回流。',\n    skills: ['dingtalk-agent-deploy', 'dingtalk-agent-boot-multica'],\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 MAP_FILE = '.dingtalk-agent/map.json'\nconst PROJECT_FILE = 'dingtalk-agent.json'\n\nexport type MapSource = 'env' | 'project-manifest' | 'map-file' | 'inferred' | 'none'\n\nexport interface MapResolution {\n  $schema: 'dingtalk-agent/map-resolution@1'\n  map: string | null\n  source: MapSource\n  file: string\n  definition: MapDefinition | null\n  platforms: MapDefinition[]\n}\n\nexport interface MapUseResult extends MapResolution {\n  written: string\n  skillInstalls: GlobalSkillStatus[]\n}\n\nexport function mapDefinition(name: string): MapDefinition | null {\n  return MANAGED_AGENT_PLATFORMS.find((item) => item.name === name) || null\n}\n\nexport function resolveMap(start = process.cwd(), env: NodeJS.ProcessEnv = process.env): MapResolution {\n  const fromEnv = String(env.DTA_MAP || '').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?.map === 'string' ? manifest.map.trim() : ''\n      if (declared) return resolution(declared, 'project-manifest', manifestPath)\n    }\n  }\n\n  const mapPath = findUp(start, MAP_FILE)\n  if (mapPath) {\n    const stored = readJsonOrNull(mapPath)\n    const declared = typeof stored?.map === 'string' ? stored.map.trim() : ''\n    if (declared) return resolution(declared, 'map-file', mapPath)\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 MapUseOptions {\n  packageRoot: string\n  home?: string\n  env?: NodeJS.ProcessEnv\n  installSkills?: boolean\n}\n\nexport function useMap(start: string, name: string, options: MapUseOptions): MapUseResult {\n  const definition = mapDefinition(name)\n  if (!definition) {\n    throw new Error(\n      `未知 managed agents 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，无法写入 map 归属`)\n    }\n    manifest.map = definition.name\n    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\\n')\n    written = manifestPath\n  } else {\n    const target = join(resolve(start), MAP_FILE)\n    mkdirSync(dirname(target), { recursive: true })\n    writeFileSync(target, JSON.stringify(\n      { $schema: 'dingtalk-agent/map@1', map: 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 { ...resolveMap(start, options.env || process.env), written, skillInstalls }\n}\n\n/** deploy/promote/observe 等平台命令的归属门禁：未归属、未知或 coming-soon 一律 fail-closed。 */\nexport function requireSupportedMap(\n  command: string, start = process.cwd(), env: NodeJS.ProcessEnv = process.env,\n): MapResolution {\n  const resolved = resolveMap(start, env)\n  if (!resolved.map) {\n    throw new Error(\n      `当前工作区未声明 managed agents platform，无法执行 \\`${command}\\`。\\n` +\n      '先运行 `dta map use multica-dingtalk`，或设置 DTA_MAP 环境变量。',\n    )\n  }\n  if (!resolved.definition) {\n    throw new Error(\n      `工作区声明了未知 platform: ${resolved.map}（来源 ${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: MapStatus): string {\n  return status === 'supported' ? '已支持' : '敬请期待'\n}\n\nfunction resolution(name: string | null, source: MapSource, file: string): MapResolution {\n  return {\n    $schema: 'dingtalk-agent/map-resolution@1',\n    map: name,\n    source,\n    file,\n    definition: name ? mapDefinition(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/multica-deploy.js

@@ -7,6 +7,7 @@ import { WORKSPACE_STATE_ROOT, inspectAgentProject, showDevelopmentWorkspace, }
 import { digest, stableStringify } from './events.js';
 import { MULTICA_BOOT_SKILL, MULTICA_EVIDENCE_ROOT, inspectMulticaWorkspace, planMulticaWorkspace, statusMulticaWorkspace, } from './multica-provider.js';
 import { resolvePackageRoot } from './package-root.js';
+import { bundledSkillPath } from './skill-manager.js';
 export const MULTICA_DEPLOYMENT_SCHEMA = 'dingtalk-agent/multica-deployment-receipt@1';
 const MAX_DEPLOY_SKILLS = 32;
 const MAX_SKILL_SUPPORTING_FILES = 128;
@@ -80,7 +81,7 @@ export function planMulticaDeployment(start, name, options = {}) {
             workspaceId: readPlan.expected.workspaceId,
             runtimeId: readPlan.expected.runtimeId,
             agentId: readPlan.expected.agentId,
-            agentName: info.project.name,
+            agentName: info.project.displayName,
             skills: expectedSkills,
             definitionHash: source.definitionHash,
             instructionsHash: source.instructionsHash,
@@ -350,7 +351,7 @@ function loadDeploymentSource(root) {
     const packageRoot = resolvePackageRoot(import.meta.url);
     skillRoots.push({
         name: MULTICA_BOOT_SKILL,
-        root: safeExternalSkillRoot(join(packageRoot, 'skills', MULTICA_BOOT_SKILL)),
+        root: safeExternalSkillRoot(bundledSkillPath(packageRoot, MULTICA_BOOT_SKILL)),
     });
     if (skillRoots.length > MAX_DEPLOY_SKILLS) {
         throw new Error(`Multica deploy 最多支持 ${MAX_DEPLOY_SKILLS} 个受管 Skills`);
@@ -598,24 +599,20 @@ function readSmoke(root, plan, marker, issueId, agentId, requiredSkills, command
         'issue', 'run-messages', taskId, '--issue', issueId, '--output', 'json',
     ]), 'smoke.issue.messages', 'read', root, env, timeoutMs, calls).stdout, 'smoke messages');
     const toolUses = messages.filter((item) => optionalString(item.type) === 'tool_use');
-    const nonSkillTools = toolUses.filter((item) => !/skill/i.test(optionalString(item.tool)));
-    const loadedSkills = requiredSkills.filter((name) => toolUses.some((item) => JSON.stringify(item.input || {}).includes(name))).sort();
+    const skillToolUses = toolUses.filter((item) => optionalString(item.tool) === 'skill');
+    const skillNames = skillToolUses.map((item) => smokeToolInput(item).name)
+        .filter((item) => typeof item === 'string' && Boolean(item)).sort();
+    const loadedSkills = requiredSkills.filter((name) => skillNames.includes(name)).sort();
     const texts = messages.filter((item) => optionalString(item.type) === 'text')
         .map((item) => optionalString(item.content)).filter(Boolean);
     const finalText = texts.at(-1) || '';
-    let responsePassed = false;
-    try {
-        const parsed = JSON.parse(finalText);
-        responsePassed = parsed?.schema === 'dta-multica-load-smoke@1' &&
-            parsed?.marker === marker &&
-            stableStringify(Array.isArray(parsed?.loaded) ? [...parsed.loaded].sort() : []) ===
-                stableStringify(requiredSkills);
-    }
-    catch {
-        responsePassed = false;
-    }
-    const toolTracePassed = nonSkillTools.length === 0 &&
-        stableStringify(loadedSkills) === stableStringify(requiredSkills);
+    const matchesResponse = (value) => smokeResponseMatches(value, marker, requiredSkills);
+    const replyWrites = toolUses.filter((item) => optionalString(item.tool) === 'write')
+        .map((item) => smokeToolInput(item)).filter((input) => optionalString(input.filePath).endsWith('/reply.md'))
+        .map((input) => optionalString(input.content)).filter(Boolean);
+    const responseEvidence = [...texts, ...replyWrites].find(matchesResponse) || '';
+    const responsePassed = Boolean(responseEvidence);
+    const toolTracePassed = toolUses.every((item) => allowedSmokeToolUse(item, issueId, marker, requiredSkills)) && stableStringify(skillNames) === stableStringify(requiredSkills);
     const failures = [];
     if (taskStatus !== 'completed')
         failures.push(`smoke.task.${taskStatus || 'unknown'}`);
@@ -626,9 +623,70 @@ function readSmoke(root, plan, marker, issueId, agentId, requiredSkills, command
     return {
         status: failures.length ? 'failed' : 'passed',
         marker, markerHash: sha256(marker), issueId, taskId, taskStatus, requiredSkills, loadedSkills,
-        toolTracePassed, responsePassed, responseHash: sha256(finalText), failures,
+        toolTracePassed, responsePassed, responseHash: sha256(responseEvidence || finalText), failures,
     };
 }
+function smokeToolInput(item) {
+    return item.input && typeof item.input === 'object' && !Array.isArray(item.input)
+        ? item.input : {};
+}
+function smokeResponseMatches(value, marker, requiredSkills) {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed?.schema === 'dta-multica-load-smoke@1' && parsed?.marker === marker &&
+            stableStringify(Array.isArray(parsed?.loaded) ? [...parsed.loaded].sort() : []) ===
+                stableStringify(requiredSkills);
+    }
+    catch {
+        return false;
+    }
+}
+function allowedSmokeToolUse(item, issueId, marker, requiredSkills) {
+    const tool = optionalString(item.tool);
+    if (tool === 'skill')
+        return true;
+    const input = smokeToolInput(item);
+    if (tool === 'write') {
+        return safeSmokeReplyPath(optionalString(input.filePath)) &&
+            smokeResponseMatches(optionalString(input.content), marker, requiredSkills);
+    }
+    if (tool !== 'bash')
+        return false;
+    const command = optionalString(input.command);
+    if (new Set([
+        `multica issue get ${issueId} --output json`,
+        `multica issue metadata list ${issueId} --output json`,
+        `multica issue comment list ${issueId} --recent 10 --output json`,
+        `multica issue status ${issueId} in_progress`,
+        `multica issue status ${issueId} in_review`,
+    ]).has(command))
+        return true;
+    const commentPrefix = `multica issue comment add ${issueId} --content-file `;
+    if (command.startsWith(commentPrefix)) {
+        return safeSmokeReplyPath(command.slice(commentPrefix.length));
+    }
+    const cleanupFirstPrefix = 'rm ';
+    const cleanupFirstSuffix = ` && multica issue status ${issueId} in_review`;
+    if (command.startsWith(cleanupFirstPrefix) && command.endsWith(cleanupFirstSuffix)) {
+        return safeSmokeReplyPath(command.slice(cleanupFirstPrefix.length, command.length - cleanupFirstSuffix.length));
+    }
+    const statusFirstPrefix = `multica issue status ${issueId} in_review && rm `;
+    if (command.startsWith(statusFirstPrefix)) {
+        return safeSmokeReplyPath(command.slice(statusFirstPrefix.length));
+    }
+    if (command.startsWith(cleanupFirstPrefix)) {
+        return safeSmokeReplyPath(command.slice(cleanupFirstPrefix.length));
+    }
+    return false;
+}
+function safeSmokeReplyPath(value) {
+    if (value === './reply.md')
+        return true;
+    if (!value.startsWith('/') || !value.endsWith('/reply.md'))
+        return false;
+    return value.split('/').every((part) => !part ||
+        (part !== '.' && part !== '..' && /^[A-Za-z0-9._-]+$/.test(part)));
+}
 function rollbackConfirmed(root, plan, command, env, timeoutMs, calls, rollback, temp) {
     const report = emptyRollback(true);
     const attempt = (id, argv) => {
@@ -833,7 +891,7 @@ export function statusMulticaDeployment(start, name, options = {}) {
             const matched = Boolean(snapshot && remoteMatchesDesired(snapshot, source, operation.runtimeId));
             const safelyBound = Boolean(snapshot?.agent && inspection.passed &&
                 snapshot.agent.id === operation.agentId &&
-                snapshot.agent.name === info.project.name &&
+                snapshot.agent.name === info.project.displayName &&
                 snapshot.agent.runtimeId === operation.runtimeId &&
                 snapshot.agent.instructions === source.instructions && !snapshot.agent.archived);
             receipt = { ...receipt,
@@ -934,7 +992,7 @@ function reconcileRemoteTarget(root, name, operation, source, command, env, time
     if (candidates.length > 10) {
         return { inspection: discovery, snapshot: null, failures: ['reconcile.agent-candidate-budget'] };
     }
-    const projectName = inspectAgentProject(root).project.name;
+    const projectName = inspectAgentProject(root).project.displayName;
     const matches = [];
     for (const [index, candidate] of candidates.entries()) {
         const inspection = inspectMulticaWorkspace(root, name, {