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

package/dist/src/agent-definition.js

@@ -0,0 +1,182 @@
+import { copyFileSync, cpSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { basename, dirname, join, relative, resolve } from 'node:path';
+import { digest, stableStringify } from './events.js';
+export function buildBootstrapDefinition(mounts, config, workspace = null) {
+    const bodyMount = mounts.find((item) => item.slot === 'body') ||
+        mounts.find((item) => item.slot === 'profile') ||
+        mounts.find((item) => item.slot === 'workspace') || null;
+    const discoveredSkills = mounts
+        .filter((item) => item.slot.startsWith('skill:'))
+        .map((item) => {
+        const metadata = readSkillMetadata(item.path);
+        return {
+            name: metadata.name || item.slot.slice('skill:'.length),
+            version: metadata.version, source: item.source,
+            path: item.path, hash: item.hash,
+        };
+    });
+    const configuredSkills = discoveredSkills.length
+        ? discoveredSkills
+        : (workspace?.skills || []).map((name) => ({
+            name, version: '', source: `workspace:${name}`, path: '', hash: '',
+        }));
+    const skills = configuredSkills.some((item) => item.name === 'dingtalk-basic-behavior')
+        ? configuredSkills
+        : [{
+                name: 'dingtalk-basic-behavior', version: '',
+                source: 'bundled:dingtalk-basic-behavior', path: '', hash: '',
+            }, ...configuredSkills];
+    const sourcePath = config.sourcePath ? resolve(config.sourcePath) : '';
+    const gitRevision = sourcePath ? readGitRevision(sourcePath) : '';
+    const sourceKind = workspace
+        ? 'workspace'
+        : config.source.startsWith('dingtalk-doc:')
+            ? 'dingtalk-doc'
+            : gitRevision ? 'git-checkout' : 'local-folder';
+    const id = cleanId(workspace?.id || (sourcePath ? basename(sourcePath) : config.source));
+    return finalize({
+        $schema: 'dingtalk-agent/agent-definition@1',
+        id,
+        source: { kind: sourceKind, uri: config.source, revision: gitRevision },
+        body: bodyMount ? { path: bodyMount.path, hash: bodyMount.hash } : null,
+        skills,
+        storage: {
+            memory: config.memory, knowledge: config.knowledge,
+            artifacts: config.artifacts, state: config.state,
+        },
+        authority: {
+            dwsProfile: config.dwsProfile,
+            expectedUserId: config.expectedUserId,
+        },
+        configuration: config.origins,
+    });
+}
+/**
+ * Definition 与 Skill 一样按 Session 冻结。新 Run 只复制已验证的 Session 快照，
+ * 因而在线修改 WORKSPACE.md、DWS profile 或启用 Skill 不会改变同一件事的身份。
+ */
+export function snapshotPreparedDefinition(runPath, sessionPath, workspace, mounts, skillManifest) {
+    const sessionRoot = join(sessionPath, 'definition');
+    const definitionPath = join(sessionRoot, 'definition.json');
+    let definition;
+    if (existsSync(definitionPath)) {
+        definition = verifyDefinition(sessionRoot);
+    }
+    else {
+        mkdirSync(sessionRoot, { recursive: true });
+        const profile = mounts.find((item) => item.slot === 'profile');
+        let body = null;
+        if (profile?.snapshotPath) {
+            const source = join(runPath, profile.snapshotPath);
+            const destination = join(sessionRoot, 'body.md');
+            copyFileSync(source, destination);
+            const markdown = readFileSync(destination, 'utf8');
+            body = { path: 'body.md', hash: digest(markdown) };
+        }
+        definition = finalize({
+            $schema: 'dingtalk-agent/agent-definition@1',
+            id: cleanId(workspace.id),
+            source: {
+                kind: 'workspace', uri: `workspace:${workspace.id}`,
+                revision: digest(stableStringify(workspace)),
+            },
+            body,
+            skills: skillManifest.entries.map((entry) => ({
+                name: entry.name, version: entry.version, source: entry.sourcePath,
+                path: entry.snapshotPath, hash: entry.hash,
+            })),
+            storage: {
+                memory: workspace.mounts.memory,
+                knowledge: workspace.mounts.knowledge,
+                artifacts: 'session:artifacts',
+                state: 'session:control-state',
+            },
+            authority: {
+                dwsProfile: workspace.dws.profile,
+                expectedUserId: workspace.dws.expectedUserId,
+            },
+            configuration: {
+                agent: 'workspace', skills: 'workspace', memory: 'workspace',
+                knowledge: 'workspace', artifacts: 'convention', state: 'convention',
+                dwsProfile: 'workspace', expectedUserId: 'workspace',
+            },
+        });
+        writeAtomic(definitionPath, JSON.stringify(definition, null, 2) + '\n');
+    }
+    const destination = join(runPath, 'context', 'agent-definition');
+    rmSync(destination, { recursive: true, force: true });
+    cpSync(sessionRoot, destination, { recursive: true });
+    return definition;
+}
+export function verifyPreparedDefinition(runPath, expectedHash = '') {
+    return verifyDefinition(join(runPath, 'context', 'agent-definition'), expectedHash);
+}
+function finalize(input) {
+    const missing = [];
+    if (!input.body)
+        missing.push('body');
+    if (!input.skills.length)
+        missing.push('skills');
+    if (!input.storage.memory)
+        missing.push('storage.memory');
+    if (!input.storage.knowledge)
+        missing.push('storage.knowledge');
+    const unsigned = {
+        ...input,
+        status: missing.length ? 'partial' : 'ready',
+        missing,
+    };
+    return { ...unsigned, hash: digest(stableStringify(unsigned)) };
+}
+function verifyDefinition(root, expectedHash = '') {
+    const path = join(root, 'definition.json');
+    if (!existsSync(path))
+        throw new Error('Agent Definition snapshot 缺少 definition.json');
+    const value = JSON.parse(readFileSync(path, 'utf8'));
+    const { hash, ...unsigned } = value;
+    if (!hash || digest(stableStringify(unsigned)) !== hash || (expectedHash && hash !== expectedHash)) {
+        throw new Error('Agent Definition snapshot hash 不一致');
+    }
+    if (value.body) {
+        const rootPath = resolve(root);
+        const bodyPath = resolve(rootPath, value.body.path);
+        const rel = relative(rootPath, bodyPath);
+        if (rel === '..' || rel.startsWith(`..${process.platform === 'win32' ? '\\' : '/'}`)) {
+            throw new Error('Agent Definition body 必须位于 snapshot 内');
+        }
+        const body = readFileSync(bodyPath, 'utf8');
+        if (digest(body) !== value.body.hash)
+            throw new Error('Agent Definition body 内容漂移');
+    }
+    return value;
+}
+function readGitRevision(path) {
+    const run = spawnSync('git', ['-C', path, 'rev-parse', '--show-toplevel', 'HEAD'], {
+        encoding: 'utf8', timeout: 2_000,
+    });
+    if (run.status !== 0)
+        return '';
+    const lines = String(run.stdout || '').trim().split(/\r?\n/);
+    return lines.length >= 2 ? lines[1] : '';
+}
+function readSkillMetadata(path) {
+    if (!path || !existsSync(path))
+        return { name: '', version: '' };
+    const text = readFileSync(path, 'utf8');
+    const block = text.match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1] || '';
+    const scalar = (name) => block.match(new RegExp(`^${name}:\\s*['"]?([^'"\\r\\n]+)['"]?\\s*$`, 'm'))?.[1]?.trim() || '';
+    const nestedVersion = block.match(/^metadata:\s*\r?\n(?:[ \t]+.*\r?\n)*?[ \t]+version:\s*['"]?([^'"\r\n]+)['"]?\s*$/m)?.[1]?.trim() || '';
+    return { name: scalar('name'), version: nestedVersion || scalar('version') };
+}
+function writeAtomic(path, value) {
+    mkdirSync(dirname(path), { recursive: true });
+    const temp = `${path}.${process.pid}.${Date.now()}.tmp`;
+    writeFileSync(temp, value, { flag: 'wx' });
+    renameSync(temp, path);
+}
+function cleanId(value) {
+    return value.replace(/^[a-z-]+:/, '').replace(/[^a-zA-Z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'agent';
+}
+//# sourceMappingURL=agent-definition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-definition.js","sourceRoot":"","sources":["../../src/agent-definition.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  copyFileSync, cpSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync,\n  writeFileSync,\n} from 'node:fs'\nimport { spawnSync } from 'node:child_process'\nimport { basename, dirname, join, relative, resolve } from 'node:path'\nimport { digest, stableStringify } from './events.js'\nimport type { AgentDefinition } from './types.js'\nimport type { BootstrapMount } from './bootstrap.js'\nimport type { SkillManifest } from './skills.js'\nimport type { MountSnapshot, WorkspaceSpec } from './workspace.js'\n\ntype Origin = AgentDefinition['configuration'][string]\n\nexport interface DefinitionConfig {\n  source: string\n  sourcePath?: string\n  memory: string\n  knowledge: string\n  artifacts: string\n  state: string\n  dwsProfile: string\n  expectedUserId: string\n  origins: Record<string, Origin>\n}\n\nexport function buildBootstrapDefinition(\n  mounts: BootstrapMount[],\n  config: DefinitionConfig,\n  workspace: WorkspaceSpec | null = null,\n): AgentDefinition {\n  const bodyMount = mounts.find((item) => item.slot === 'body') ||\n    mounts.find((item) => item.slot === 'profile') ||\n    mounts.find((item) => item.slot === 'workspace') || null\n  const discoveredSkills = mounts\n    .filter((item) => item.slot.startsWith('skill:'))\n    .map((item) => {\n      const metadata = readSkillMetadata(item.path)\n      return {\n        name: metadata.name || item.slot.slice('skill:'.length),\n        version: metadata.version, source: item.source,\n        path: item.path, hash: item.hash,\n      }\n    })\n  const configuredSkills = discoveredSkills.length\n    ? discoveredSkills\n    : (workspace?.skills || []).map((name) => ({\n      name, version: '', source: `workspace:${name}`, path: '', hash: '',\n    }))\n  const skills = configuredSkills.some((item) => item.name === 'dingtalk-basic-behavior')\n    ? configuredSkills\n    : [{\n      name: 'dingtalk-basic-behavior', version: '',\n      source: 'bundled:dingtalk-basic-behavior', path: '', hash: '',\n    }, ...configuredSkills]\n  const sourcePath = config.sourcePath ? resolve(config.sourcePath) : ''\n  const gitRevision = sourcePath ? readGitRevision(sourcePath) : ''\n  const sourceKind: AgentDefinition['source']['kind'] = workspace\n    ? 'workspace'\n    : config.source.startsWith('dingtalk-doc:')\n      ? 'dingtalk-doc'\n      : gitRevision ? 'git-checkout' : 'local-folder'\n  const id = cleanId(workspace?.id || (sourcePath ? basename(sourcePath) : config.source))\n  return finalize({\n    $schema: 'dingtalk-agent/agent-definition@1',\n    id,\n    source: { kind: sourceKind, uri: config.source, revision: gitRevision },\n    body: bodyMount ? { path: bodyMount.path, hash: bodyMount.hash } : null,\n    skills,\n    storage: {\n      memory: config.memory, knowledge: config.knowledge,\n      artifacts: config.artifacts, state: config.state,\n    },\n    authority: {\n      dwsProfile: config.dwsProfile,\n      expectedUserId: config.expectedUserId,\n    },\n    configuration: config.origins,\n  })\n}\n\n/**\n * Definition 与 Skill 一样按 Session 冻结。新 Run 只复制已验证的 Session 快照，\n * 因而在线修改 WORKSPACE.md、DWS profile 或启用 Skill 不会改变同一件事的身份。\n */\nexport function snapshotPreparedDefinition(\n  runPath: string,\n  sessionPath: string,\n  workspace: WorkspaceSpec,\n  mounts: MountSnapshot[],\n  skillManifest: SkillManifest,\n): AgentDefinition {\n  const sessionRoot = join(sessionPath, 'definition')\n  const definitionPath = join(sessionRoot, 'definition.json')\n  let definition: AgentDefinition\n  if (existsSync(definitionPath)) {\n    definition = verifyDefinition(sessionRoot)\n  } else {\n    mkdirSync(sessionRoot, { recursive: true })\n    const profile = mounts.find((item) => item.slot === 'profile')\n    let body: AgentDefinition['body'] = null\n    if (profile?.snapshotPath) {\n      const source = join(runPath, profile.snapshotPath)\n      const destination = join(sessionRoot, 'body.md')\n      copyFileSync(source, destination)\n      const markdown = readFileSync(destination, 'utf8')\n      body = { path: 'body.md', hash: digest(markdown) }\n    }\n    definition = finalize({\n      $schema: 'dingtalk-agent/agent-definition@1',\n      id: cleanId(workspace.id),\n      source: {\n        kind: 'workspace', uri: `workspace:${workspace.id}`,\n        revision: digest(stableStringify(workspace)),\n      },\n      body,\n      skills: skillManifest.entries.map((entry) => ({\n        name: entry.name, version: entry.version, source: entry.sourcePath,\n        path: entry.snapshotPath, hash: entry.hash,\n      })),\n      storage: {\n        memory: workspace.mounts.memory,\n        knowledge: workspace.mounts.knowledge,\n        artifacts: 'session:artifacts',\n        state: 'session:control-state',\n      },\n      authority: {\n        dwsProfile: workspace.dws.profile,\n        expectedUserId: workspace.dws.expectedUserId,\n      },\n      configuration: {\n        agent: 'workspace', skills: 'workspace', memory: 'workspace',\n        knowledge: 'workspace', artifacts: 'convention', state: 'convention',\n        dwsProfile: 'workspace', expectedUserId: 'workspace',\n      },\n    })\n    writeAtomic(definitionPath, JSON.stringify(definition, null, 2) + '\\n')\n  }\n\n  const destination = join(runPath, 'context', 'agent-definition')\n  rmSync(destination, { recursive: true, force: true })\n  cpSync(sessionRoot, destination, { recursive: true })\n  return definition\n}\n\nexport function verifyPreparedDefinition(runPath: string, expectedHash = ''): AgentDefinition {\n  return verifyDefinition(join(runPath, 'context', 'agent-definition'), expectedHash)\n}\n\nfunction finalize(\n  input: Omit<AgentDefinition, 'status' | 'missing' | 'hash'>,\n): AgentDefinition {\n  const missing: string[] = []\n  if (!input.body) missing.push('body')\n  if (!input.skills.length) missing.push('skills')\n  if (!input.storage.memory) missing.push('storage.memory')\n  if (!input.storage.knowledge) missing.push('storage.knowledge')\n  const unsigned = {\n    ...input,\n    status: missing.length ? 'partial' as const : 'ready' as const,\n    missing,\n  }\n  return { ...unsigned, hash: digest(stableStringify(unsigned)) }\n}\n\nfunction verifyDefinition(root: string, expectedHash = ''): AgentDefinition {\n  const path = join(root, 'definition.json')\n  if (!existsSync(path)) throw new Error('Agent Definition snapshot 缺少 definition.json')\n  const value = JSON.parse(readFileSync(path, 'utf8')) as AgentDefinition\n  const { hash, ...unsigned } = value\n  if (!hash || digest(stableStringify(unsigned)) !== hash || (expectedHash && hash !== expectedHash)) {\n    throw new Error('Agent Definition snapshot hash 不一致')\n  }\n  if (value.body) {\n    const rootPath = resolve(root)\n    const bodyPath = resolve(rootPath, value.body.path)\n    const rel = relative(rootPath, bodyPath)\n    if (rel === '..' || rel.startsWith(`..${process.platform === 'win32' ? '\\\\' : '/'}`)) {\n      throw new Error('Agent Definition body 必须位于 snapshot 内')\n    }\n    const body = readFileSync(bodyPath, 'utf8')\n    if (digest(body) !== value.body.hash) throw new Error('Agent Definition body 内容漂移')\n  }\n  return value\n}\n\nfunction readGitRevision(path: string): string {\n  const run = spawnSync('git', ['-C', path, 'rev-parse', '--show-toplevel', 'HEAD'], {\n    encoding: 'utf8', timeout: 2_000,\n  })\n  if (run.status !== 0) return ''\n  const lines = String(run.stdout || '').trim().split(/\\r?\\n/)\n  return lines.length >= 2 ? lines[1] : ''\n}\n\nfunction readSkillMetadata(path: string): { name: string; version: string } {\n  if (!path || !existsSync(path)) return { name: '', version: '' }\n  const text = readFileSync(path, 'utf8')\n  const block = text.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---/)?.[1] || ''\n  const scalar = (name: string) =>\n    block.match(new RegExp(`^${name}:\\\\s*['\"]?([^'\"\\\\r\\\\n]+)['\"]?\\\\s*$`, 'm'))?.[1]?.trim() || ''\n  const nestedVersion = block.match(\n    /^metadata:\\s*\\r?\\n(?:[ \\t]+.*\\r?\\n)*?[ \\t]+version:\\s*['\"]?([^'\"\\r\\n]+)['\"]?\\s*$/m,\n  )?.[1]?.trim() || ''\n  return { name: scalar('name'), version: nestedVersion || scalar('version') }\n}\n\nfunction writeAtomic(path: string, value: string): void {\n  mkdirSync(dirname(path), { recursive: true })\n  const temp = `${path}.${process.pid}.${Date.now()}.tmp`\n  writeFileSync(temp, value, { flag: 'wx' })\n  renameSync(temp, path)\n}\n\nfunction cleanId(value: string): string {\n  return value.replace(/^[a-z-]+:/, '').replace(/[^a-zA-Z0-9._-]+/g, '-')\n    .replace(/^-+|-+$/g, '') || 'agent'\n}\n"]}