@gt-fe/eap-sdk 0.2.18 → 0.2.20

package/dist/validation/validate-agent-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-agent-project.d.ts","sourceRoot":"","sources":["../../src/validation/validate-agent-project.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,4BAA4B,EAAmB,MAAM,YAAY,CAAC;AAEhF,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,4BAA4B,CA+BhF"}

package/dist/validation/validate-agent-project.js

@@ -0,0 +1,169 @@
+import { existsSync, lstatSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { loadProjectRuntimeConfig } from '../config/index.js';
+import { resolveAgentProject } from '../discovery/index.js';
+import { declaredResourceCodes, findUndeclaredLockedResources, LockedResourceResolutionError, readEapLock, resolveLockedResources, } from '../lockfile/index.js';
+import { configuredLocalResourceCodes, discoverConfiguredLocalResources, } from '../resources/configured-local-resources.js';
+import { hasOfficialSkillPackage, readLocalAgentResource } from '../resources/local-resource.js';
+import { validateAgentDirectory } from './validate-agent-directory.js';
+export function validateAgentProject(root) {
+    const project = resolveAgentProject(root ? { root } : {});
+    const result = validateAgentDirectory(project);
+    const issues = [...result.issues];
+    let configuredLocalResources = [];
+    try {
+        const loaded = loadProjectRuntimeConfig({ root: project.root });
+        configuredLocalResources = discoverConfiguredLocalResources(project.root, loaded.config);
+    }
+    catch (error) {
+        issues.push({
+            severity: 'error',
+            code: 'project_config.invalid',
+            message: error instanceof Error ? error.message : String(error),
+            filePath: resolve(project.root, 'eap.config.json'),
+            agentCode: project.agentCode,
+            version: project.version,
+        });
+    }
+    if (result.agent) {
+        validateLockResources(project.root, result.agent.manifest, configuredLocalResources, issues);
+    }
+    const uniqueIssues = dedupeIssues(issues);
+    return {
+        root: project.root,
+        valid: uniqueIssues.every((issue) => issue.severity !== 'error'),
+        issues: uniqueIssues,
+        ...(result.agent ? { agent: result.agent } : {}),
+    };
+}
+/** 同一个校验失败可能被多个子校验器重复上报，这里按 code+filePath+jsonPath+message 去重。 */
+function dedupeIssues(issues) {
+    const seen = new Set();
+    const unique = [];
+    for (const issue of issues) {
+        const key = [
+            issue.severity,
+            issue.code,
+            issue.filePath ?? '',
+            issue.jsonPath ?? '',
+            issue.message,
+        ].join('\u0000');
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        unique.push(issue);
+    }
+    return unique;
+}
+function validateLockResources(root, manifest, configuredLocalResources, issues) {
+    const configuredCodes = configuredLocalResourceCodes(configuredLocalResources);
+    for (const code of declaredResourceCodes(manifest, 'skills')) {
+        if (configuredCodes.skills?.has(code))
+            continue;
+        const directory = resolve(root, 'skills', code);
+        if (!hasOfficialSkillPackage(root, code))
+            continue;
+        try {
+            readLocalAgentResource(directory, 'skill', code);
+        }
+        catch (error) {
+            issues.push({
+                severity: 'error',
+                code: 'skill.invalid_entry',
+                message: error instanceof Error ? error.message : String(error),
+                filePath: directory,
+                agentCode: manifest.code,
+                version: manifest.version,
+            });
+        }
+    }
+    const skillsNeedingLock = declaredResourceCodes(manifest, 'skills')
+        .filter((code) => !configuredCodes.skills?.has(code) && !hasOfficialSkillPackage(root, code));
+    const toolsNeedingLock = declaredResourceCodes(manifest, 'tools')
+        .filter((code) => !configuredCodes.tools?.has(code));
+    const hasMaterializedDependencies = toolsNeedingLock.length > 0
+        || skillsNeedingLock.length > 0;
+    let lock;
+    try {
+        lock = readEapLock(root);
+    }
+    catch (error) {
+        issues.push(lockIssue('lockfile.invalid', error, resolve(root, 'eap.lock.yaml')));
+        return;
+    }
+    if (!lock) {
+        issues.push({
+            severity: 'error',
+            code: 'lockfile.missing',
+            message: hasMaterializedDependencies
+                ? '声明了 Tool 或 Skill 依赖时，需要 eap.lock.yaml。请运行 eap install 生成锁文件。'
+                : 'Agent Runtime 物化需要 eap.lock.yaml。请运行 eap install 生成锁文件。',
+            filePath: resolve(root, 'eap.lock.yaml'),
+            agentCode: manifest.code,
+            version: manifest.version,
+        });
+        return;
+    }
+    try {
+        const resources = resolveLockedResources({
+            root,
+            manifest,
+            lock,
+            availableLocalResources: configuredCodes,
+        });
+        for (const resource of resources) {
+            if (resource.source !== 'registry')
+                continue;
+            const localPath = resolve(root, resource.kind, resource.code);
+            if (existsSync(localPath) && lstatSync(localPath).isDirectory()) {
+                issues.push({
+                    severity: 'error',
+                    code: 'lockfile.local_registry_conflict',
+                    message: `Registry ${resource.kind.slice(0, -1)} ${resource.code} 与本地目录 ${localPath} 冲突。请删除本地目录或改用 registry 版本后重新同步。`,
+                    filePath: localPath,
+                    agentCode: manifest.code,
+                    version: manifest.version,
+                });
+            }
+        }
+    }
+    catch (error) {
+        issues.push(lockResourceIssue(error, resolve(root, 'eap.lock.yaml'), manifest.code, manifest.version));
+    }
+    for (const resource of findUndeclaredLockedResources(manifest, lock)) {
+        issues.push({
+            severity: 'warning',
+            code: 'lockfile.undeclared_resource',
+            message: `eap.lock.yaml 中锁定的 ${resource.kind.slice(0, -1)} ${resource.code}@${resource.version} 未被 agent.manifest.json 引用。请运行 eap install 同步以清理该未引用记录。`,
+            filePath: resolve(root, 'eap.lock.yaml'),
+            agentCode: manifest.code,
+            version: manifest.version,
+        });
+    }
+}
+function lockResourceIssue(error, filePath, agentCode, version) {
+    const message = error instanceof Error ? error.message : String(error);
+    const resource = error instanceof LockedResourceResolutionError ? error.resource : undefined;
+    const guidance = resource && message.startsWith('未锁定')
+        ? `。请运行 eap install ${resource.code} --type ${resource.kind.slice(0, -1)} 安装该资源`
+        : '';
+    return {
+        severity: 'error',
+        code: 'lockfile.invalid_resource',
+        message: `${message}${guidance}`,
+        filePath,
+        agentCode,
+        version,
+    };
+}
+function lockIssue(code, error, filePath, agentCode, version) {
+    return {
+        severity: 'error',
+        code,
+        message: error instanceof Error ? error.message : String(error),
+        filePath,
+        agentCode,
+        version,
+    };
+}
+//# sourceMappingURL=validate-agent-project.js.map

package/dist/validation/validate-agent-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-agent-project.js","sourceRoot":"","sources":["../../src/validation/validate-agent-project.ts"],"names":[],"mappings":"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"}

package/dist/validation/validate-graph.d.ts

@@ -0,0 +1,8 @@
+import type { AgentManifest, Graph } from '../schema/index.js';
+import type { ValidationIssue } from './types.js';
+export interface GraphValidationResult {
+    graph?: Graph;
+    issues: ValidationIssue[];
+}
+export declare function validateGraph(value: unknown, filePath: string, manifest?: AgentManifest): GraphValidationResult;
+//# sourceMappingURL=validate-graph.d.ts.map

package/dist/validation/validate-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-graph.d.ts","sourceRoot":"","sources":["../../src/validation/validate-graph.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,aAAa,GACvB,qBAAqB,CA0IvB"}

package/dist/validation/validate-graph.js

@@ -0,0 +1,199 @@
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { GraphSchema, resolveDeclaredModels } from '../schema/index.js';
+export function validateGraph(value, filePath, manifest) {
+    const parsed = GraphSchema.safeParse(value);
+    if (!parsed.success) {
+        return {
+            issues: parsed.error.issues.map((issue) => ({
+                severity: 'error',
+                code: 'graph.schema.invalid',
+                message: issue.message,
+                filePath,
+                jsonPath: toJsonPath(issue.path),
+            })),
+        };
+    }
+    const graph = parsed.data;
+    const issues = [];
+    if (graph.config?.maxIterations != null) {
+        issues.push(warning('graph.config.max_iterations_ignored', 'graph.config.maxIterations 已废弃，Runtime 忽略。整图限长请用 config.timeout（请求优先，否则图上的值，再否则 1200000 毫秒）。RAG 节点 config.maxIterations 是该节点检索轮次，到上限该节点结束、后续图节点继续。', filePath, 'config.maxIterations'));
+    }
+    const nodeIds = new Set();
+    for (const [index, node] of graph.nodes.entries()) {
+        if (nodeIds.has(node.id)) {
+            issues.push(error('graph.duplicate_node_id', `图节点 id 重复：${node.id}。请为每个节点使用唯一的 id。`, filePath, `nodes[${index}].id`));
+        }
+        nodeIds.add(node.id);
+    }
+    const validEndpoint = (id) => id === '__start__' || id === '__end__' || nodeIds.has(id);
+    const adjacency = new Map();
+    const outgoing = new Map();
+    for (const id of nodeIds) {
+        adjacency.set(id, new Set());
+        outgoing.set(id, new Set());
+    }
+    const addEdge = (from, to, path) => {
+        if (!validEndpoint(from))
+            issues.push(error('graph.invalid_edge_from', `边引用了不存在的起点：${from}。请确认边的 from 指向一个已声明的节点 id。`, filePath, `${path}.from`));
+        if (!validEndpoint(to))
+            issues.push(error('graph.invalid_edge_to', `边引用了不存在的终点：${to}。请确认边的 to 指向一个已声明的节点 id。`, filePath, `${path}.to`));
+        if (nodeIds.has(from))
+            outgoing.get(from).add(to);
+        if (nodeIds.has(from) && nodeIds.has(to))
+            adjacency.get(from).add(to);
+    };
+    graph.edges.forEach((edge, index) => addEdge(edge.from, edge.to, `edges[${index}]`));
+    graph.conditionalEdges?.forEach((edge, index) => {
+        if (!nodeIds.has(edge.from)) {
+            issues.push(error('graph.invalid_conditional_source', `条件边引用了不存在的起点：${edge.from}。请确认 from 指向一个已声明的节点 id。`, filePath, `conditionalEdges[${index}].from`));
+        }
+        edge.branches.forEach((branch, branchIndex) => {
+            addEdge(edge.from, branch.to, `conditionalEdges[${index}].branches[${branchIndex}]`);
+        });
+        if (edge.fallback)
+            addEdge(edge.from, edge.fallback, `conditionalEdges[${index}].fallback`);
+    });
+    const startNodes = new Set();
+    if (graph.entryPoint) {
+        if (!nodeIds.has(graph.entryPoint)) {
+            issues.push(error('graph.invalid_entry_point', `入口节点不存在：${graph.entryPoint}。请确认 entryPoint 指向一个已声明的节点 id。`, filePath, 'entryPoint'));
+        }
+        else {
+            startNodes.add(graph.entryPoint);
+        }
+    }
+    else {
+        for (const edge of graph.edges) {
+            if (edge.from === '__start__' && nodeIds.has(edge.to))
+                startNodes.add(edge.to);
+        }
+        if (startNodes.size === 0) {
+            issues.push(error('graph.missing_entry_point', '图缺少入口：请设置 entryPoint，或添加一条从 __start__ 出发的边。', filePath));
+        }
+    }
+    if (graph.finishPoints?.length) {
+        graph.finishPoints.forEach((finishPoint, index) => {
+            if (finishPoint !== '__end__' && !nodeIds.has(finishPoint)) {
+                issues.push(error('graph.invalid_finish_point', `结束节点不存在：${finishPoint}。请确认 finishPoint 指向一个已声明的节点 id。`, filePath, `finishPoints[${index}]`));
+            }
+        });
+    }
+    else if (!graph.edges.some((edge) => edge.to === '__end__')) {
+        issues.push(error('graph.missing_finish_point', '图缺少结束点：请设置 finishPoints，或添加一条指向 __end__ 的边。', filePath));
+    }
+    const reachable = new Set();
+    const pending = [...startNodes];
+    while (pending.length > 0) {
+        const nodeId = pending.pop();
+        if (reachable.has(nodeId))
+            continue;
+        reachable.add(nodeId);
+        for (const next of adjacency.get(nodeId) ?? [])
+            pending.push(next);
+    }
+    for (const nodeId of nodeIds) {
+        if (!reachable.has(nodeId)) {
+            issues.push(error('graph.unreachable_node', `节点不可达：${nodeId}。请确认该节点能从入口（entryPoint / __start__）到达。`, filePath, `nodes[${graph.nodes.findIndex((node) => node.id === nodeId)}]`));
+        }
+    }
+    graph.nodes.forEach((node, index) => {
+        if (node.type !== 'tool')
+            return;
+        if ((outgoing.get(node.id)?.size ?? 0) > 0)
+            return;
+        issues.push(error('graph.tool_node_no_outgoing', `Tool node ${node.id} has no outgoing edge. LangGraph ends after the tool runs; ReAct must add { "from": "${node.id}", "to": "<llm>" }.`, filePath, `nodes[${index}]`));
+    });
+    const toolIds = new Set(graph.nodes.filter((node) => node.type === 'tool').map((node) => node.id));
+    const canReachTool = (start) => {
+        const seen = new Set();
+        const queue = [start];
+        while (queue.length > 0) {
+            const id = queue.pop();
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            for (const next of adjacency.get(id) ?? []) {
+                if (toolIds.has(next))
+                    return true;
+                queue.push(next);
+            }
+        }
+        return false;
+    };
+    graph.nodes.forEach((node, index) => {
+        if (node.type !== 'llm')
+            return;
+        if (node.config.disableTools === true)
+            return;
+        if (canReachTool(node.id))
+            return;
+        issues.push(error('graph.llm_tools_no_tool_node', `LLM node ${node.id} exposes tools but has no path to a type:tool node. Set disableTools or add a tool successor; otherwise tool_calls have nowhere to run.`, filePath, `nodes[${index}]`));
+    });
+    validatePromptFiles(graph, filePath, issues);
+    if (manifest)
+        validateManifestReferences(graph, manifest, filePath, issues);
+    return { graph, issues };
+}
+function validatePromptFiles(graph, filePath, issues) {
+    const root = dirname(filePath);
+    graph.nodes.forEach((node, index) => {
+        if (node.type !== 'llm')
+            return;
+        const refs = [node.config.systemPromptFile, node.config.systemPrompt].filter((item) => typeof item === 'string');
+        for (const ref of refs) {
+            const spec = ref.trim();
+            const relative = /^\.\/[A-Za-z0-9._/-]+\.(md|txt)$/.test(spec);
+            const absolute = /^(?:\/|[A-Za-z]:[\\/])[^\r\n]+\.(md|txt)$/i.test(spec);
+            if (!relative && !absolute)
+                continue;
+            const target = relative ? resolve(root, spec.slice(2)) : resolve(spec);
+            if (!existsSync(target)) {
+                issues.push(error('graph.prompt_file_missing', `提示词文件不存在：${spec}。请检查 systemPromptFile / systemPrompt 引用的文件路径是否正确。`, filePath, `nodes[${index}].config.systemPrompt`));
+            }
+        }
+    });
+}
+function validateManifestReferences(graph, manifest, filePath, issues) {
+    const llmNodes = graph.nodes
+        .map((node, index) => ({ node, index }))
+        .filter((item) => item.node.type === 'llm');
+    if (llmNodes.length > 0) {
+        const { allowed } = resolveDeclaredModels(manifest);
+        if (allowed.length === 0) {
+            issues.push(error('agent.models.missing', '图上存在 llm 节点，但 agent.manifest.json 未声明 models.default。请在 agent.manifest.json 的 models.default 中填写默认模型，或在 models.allowed 中声明可用模型。', filePath, 'models'));
+        }
+        else {
+            for (const { node, index } of llmNodes) {
+                const model = node.type === 'llm' ? node.config.model?.trim() : undefined;
+                if (model && !allowed.includes(model)) {
+                    issues.push(error('graph.undeclared_model', `图 llm 节点 ${node.id} 使用了模型 ${model}，但该模型未声明在 agent.manifest.json 的 models.default / models.allowed 中。请将 ${model} 加入 models.allowed，或改用已声明的模型。`, filePath, `nodes[${index}].config.model`));
+                }
+            }
+        }
+    }
+    const skillRefs = graph.nodes
+        .filter((node) => node.type === 'subgraph')
+        .flatMap((node) => {
+        const skill = node.config.skillId ?? node.config.skillCode ?? node.subgraphId;
+        return skill ? [skill] : [];
+    });
+    for (const skill of skillRefs) {
+        const declaredSkills = new Set(manifest.skillRefs.map((ref) => ref.code));
+        if (!declaredSkills.has(skill)) {
+            issues.push(error('graph.undeclared_skill', `图上的 Subgraph 节点引用了 Skill ${skill}，但未在 agent.manifest.json 的 skillRefs 中声明。请在 skillRefs 中加入 { "code": "${skill}", "version": "..." }，或运行 eap install 安装该 Skill。`, filePath));
+        }
+    }
+}
+function error(code, message, filePath, jsonPath) {
+    return { severity: 'error', code, message, filePath, jsonPath };
+}
+function warning(code, message, filePath, jsonPath) {
+    return { severity: 'warning', code, message, filePath, jsonPath };
+}
+function toJsonPath(path) {
+    if (path.length === 0)
+        return undefined;
+    return path.map((segment) => typeof segment === 'number' ? `[${segment}]` : segment).join('.').replace('.[', '[');
+}
+//# sourceMappingURL=validate-graph.js.map

package/dist/validation/validate-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-graph.js","sourceRoot":"","sources":["../../src/validation/validate-graph.ts"],"names":[],"mappings":"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"}

package/dist/validation/validate-local-llm.d.ts

@@ -0,0 +1,7 @@
+import type { AgentManifest } from '../schema/agent/manifest.js';
+import type { ValidationIssue } from './types.js';
+export declare function validateLocalLlmAgainstManifest(root: string, manifest: AgentManifest, extra?: {
+    agentCode?: string;
+    version?: string;
+}): ValidationIssue[];
+//# sourceMappingURL=validate-local-llm.d.ts.map

package/dist/validation/validate-local-llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-local-llm.d.ts","sourceRoot":"","sources":["../../src/validation/validate-local-llm.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,EACvB,KAAK,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,eAAe,EAAE,CAyCnB"}

package/dist/validation/validate-local-llm.js

@@ -0,0 +1,44 @@
+import { resolve } from 'node:path';
+import { loadProjectRuntimeConfig, ProjectRuntimeConfigError } from '../config/index.js';
+import { resolveDeclaredModels } from '../schema/agent/models.js';
+export function validateLocalLlmAgainstManifest(root, manifest, extra) {
+    const configPath = resolve(root, 'eap.config.json');
+    let config;
+    try {
+        config = loadProjectRuntimeConfig({ root }).config;
+    }
+    catch (error) {
+        if (error instanceof ProjectRuntimeConfigError) {
+            return [{
+                    severity: 'error',
+                    code: 'project_config.invalid',
+                    message: error.message,
+                    filePath: error.path,
+                    ...extra,
+                }];
+        }
+        return [];
+    }
+    if (config.runtime.deploymentContext !== 'dev' || !config.runtime.llm)
+        return [];
+    const issues = [];
+    const { allowed } = resolveDeclaredModels(manifest);
+    const llmModels = Object.keys(config.runtime.llm.models ?? {});
+    const hasDefault = Boolean(config.runtime.llm.baseUrl && config.runtime.llm.apiKey);
+    if (allowed.length > 0 && !hasDefault) {
+        for (const model of allowed) {
+            if (!llmModels.includes(model)) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'project_config.missing_llm_gateway',
+                    message: `agent.manifest.json 声明了模型 ${model}，但 eap.config.json 的 runtime.llm.models 中缺少其网关配置；本地调用会失败，除非设置了默认的 runtime.llm.baseUrl/apiKey。请在 runtime.llm.models.${model} 下补充 baseUrl 与 apiKey。`,
+                    filePath: configPath,
+                    jsonPath: 'runtime.llm.models',
+                    ...extra,
+                });
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=validate-local-llm.js.map

package/dist/validation/validate-local-llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-local-llm.js","sourceRoot":"","sources":["../../src/validation/validate-local-llm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,MAAM,UAAU,+BAA+B,CAC7C,IAAY,EACZ,QAAuB,EACvB,KAAgD;IAEhD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACpD,IAAI,MAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,wBAAwB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,yBAAyB,EAAE,CAAC;YAC/C,OAAO,CAAC;oBACN,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,wBAAwB;oBAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,QAAQ,EAAE,KAAK,CAAC,IAAI;oBACpB,GAAG,KAAK;iBACT,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEjF,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAE/D,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ,EAAE,SAAS;oBACnB,IAAI,EAAE,oCAAoC;oBAC1C,OAAO,EAAE,6BAA6B,KAAK,sHAAsH,KAAK,wBAAwB;oBAC9L,QAAQ,EAAE,UAAU;oBACpB,QAAQ,EAAE,oBAAoB;oBAC9B,GAAG,KAAK;iBACT,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const SDK_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,WAAW,QAA0B,CAAC"}

package/dist/version.js

@@ -0,0 +1,5 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const packageMetadata = require('../package.json');
+export const SDK_VERSION = packageMetadata.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAuB,CAAC;AAEzE,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gt-fe/eap-sdk",
-  "version": "0.2.18",
+  "version": "0.2.20",
   "description": "EAP Agent 开发 SDK — Runtime 开发服务、项目校验与确定性打包",
   "type": "module",
   "main": "./dist/index.js",