@gt-fe/eap-sdk 0.2.18 → 0.2.19

package/dist/schema/package-manifest.d.ts

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+export declare const PackageManifestSchema: z.ZodObject<{
+    packageVersion: z.ZodLiteral<2>;
+    agents: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        version: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        version: string;
+    }, {
+        code: string;
+        version: string;
+    }>, "many">, {
+        code: string;
+        version: string;
+    }[], {
+        code: string;
+        version: string;
+    }[]>;
+    files: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        size: z.ZodNumber;
+        digest: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        size: number;
+        digest: string;
+    }, {
+        path: string;
+        size: number;
+        digest: string;
+    }>, "many">, {
+        path: string;
+        size: number;
+        digest: string;
+    }[], {
+        path: string;
+        size: number;
+        digest: string;
+    }[]>;
+}, "strict", z.ZodTypeAny, {
+    packageVersion: 2;
+    agents: {
+        code: string;
+        version: string;
+    }[];
+    files: {
+        path: string;
+        size: number;
+        digest: string;
+    }[];
+}, {
+    packageVersion: 2;
+    agents: {
+        code: string;
+        version: string;
+    }[];
+    files: {
+        path: string;
+        size: number;
+        digest: string;
+    }[];
+}>;
+export type PackageManifest = z.infer<typeof PackageManifestSchema>;
+//# sourceMappingURL=package-manifest.d.ts.map

package/dist/schema/package-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manifest.d.ts","sourceRoot":"","sources":["../../src/schema/package-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+CxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIU,CAAC;AAE7C,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schema/package-manifest.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { AgentCodeSchema, SemanticVersionSchema, Sha256DigestSchema } from './common.js';
+const PackageAgentSchema = z.object({
+    code: AgentCodeSchema,
+    version: SemanticVersionSchema,
+}).strict().describe('包中包含的一个 Agent 的编码和版本。');
+const PackageFileSchema = z.object({
+    path: z.string().min(1).describe('文件在版本 Runtime 包根目录中的相对路径。'),
+    size: z.number().int().nonnegative().describe('文件大小，单位为字节。'),
+    digest: Sha256DigestSchema,
+}).strict().describe('包中一个文件的完整性记录。');
+function uniquePackageAgents() {
+    return z.array(PackageAgentSchema).length(1).superRefine((agents, context) => {
+        const identities = new Set();
+        agents.forEach((agent, index) => {
+            const identity = `${agent.code}@${agent.version}`;
+            if (identities.has(identity)) {
+                context.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `打包清单中存在重复的 Agent：${identity}`,
+                    path: [index],
+                });
+            }
+            identities.add(identity);
+        });
+    });
+}
+function uniquePackageFiles() {
+    return z.array(PackageFileSchema).superRefine((files, context) => {
+        const paths = new Set();
+        files.forEach((file, index) => {
+            if (paths.has(file.path)) {
+                context.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `打包清单中存在重复的文件记录：${file.path}`,
+                    path: [index, 'path'],
+                });
+            }
+            paths.add(file.path);
+        });
+    });
+}
+export const PackageManifestSchema = z.object({
+    packageVersion: z.literal(2).describe('包清单结构版本，当前固定为 2。'),
+    agents: uniquePackageAgents().describe('包内包含的 Agent 列表，编码和版本的组合不能重复。'),
+    files: uniquePackageFiles().describe('包内文件的完整性记录列表，文件路径不能重复。'),
+}).strict().describe('扁平 Agent 版本包清单的完整结构。');
+//# sourceMappingURL=package-manifest.js.map

package/dist/schema/package-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manifest.js","sourceRoot":"","sources":["../../src/schema/package-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEzF,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,qBAAqB;CAC/B,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;AAE9C,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC5D,MAAM,EAAE,kBAAkB;CAC3B,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAEtC,SAAS,mBAAmB;IAC1B,OAAO,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;QAC3E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC9B,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClD,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,QAAQ,CAAC;oBACf,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;oBAC3B,OAAO,EAAE,oBAAoB,QAAQ,EAAE;oBACvC,IAAI,EAAE,CAAC,KAAK,CAAC;iBACd,CAAC,CAAC;YACL,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QAC/D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC5B,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,QAAQ,CAAC;oBACf,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;oBAC3B,OAAO,EAAE,kBAAkB,IAAI,CAAC,IAAI,EAAE;oBACtC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;iBACtB,CAAC,CAAC;YACL,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACzD,MAAM,EAAE,mBAAmB,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACtE,KAAK,EAAE,kBAAkB,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CAC/D,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC"}

package/dist/schema/project-config.d.ts

@@ -0,0 +1,319 @@
+import { z } from 'zod';
+export declare const EapProjectConfigSchema: z.ZodObject<{
+    version: z.ZodEffects<z.ZodString, string, string>;
+    localToolDirectories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    localSkillDirectories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    platform: z.ZodObject<{
+        foundationServiceUrl: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>>>;
+        portalUrl: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        portalUrl: string;
+        foundationServiceUrl?: string | null | undefined;
+    }, {
+        portalUrl: string;
+        foundationServiceUrl?: string | null | undefined;
+    }>;
+    runtime: z.ZodObject<{
+        deploymentContext: z.ZodEnum<["dev", "desktop", "server"]>;
+        governance: z.ZodObject<{
+            enabled: z.ZodBoolean;
+        }, "strict", z.ZodTypeAny, {
+            enabled: boolean;
+        }, {
+            enabled: boolean;
+        }>;
+        storage: z.ZodObject<{
+            profile: z.ZodEnum<["test", "dev", "integration", "production"]>;
+            checkpointDir: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            profile: "dev" | "test" | "integration" | "production";
+            checkpointDir: string;
+        }, {
+            profile: "dev" | "test" | "integration" | "production";
+            checkpointDir: string;
+        }>;
+        tools: z.ZodObject<{
+            mode: z.ZodEnum<["mcp", "http-debug"]>;
+            localDirectory: z.ZodString;
+            gatewayTransport: z.ZodEnum<["mcp", "http"]>;
+        }, "strict", z.ZodTypeAny, {
+            mode: "mcp" | "http-debug";
+            localDirectory: string;
+            gatewayTransport: "mcp" | "http";
+        }, {
+            mode: "mcp" | "http-debug";
+            localDirectory: string;
+            gatewayTransport: "mcp" | "http";
+        }>;
+        builtins: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            timeoutMs: z.ZodOptional<z.ZodNumber>;
+            maxTimeoutMs: z.ZodOptional<z.ZodNumber>;
+            maxReadBytes: z.ZodOptional<z.ZodNumber>;
+            maxOutputBytes: z.ZodOptional<z.ZodNumber>;
+            envAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            timeoutMs?: number | undefined;
+            enabled?: boolean | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxReadBytes?: number | undefined;
+            maxOutputBytes?: number | undefined;
+            envAllowlist?: string[] | undefined;
+        }, {
+            timeoutMs?: number | undefined;
+            enabled?: boolean | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxReadBytes?: number | undefined;
+            maxOutputBytes?: number | undefined;
+            envAllowlist?: string[] | undefined;
+        }>>;
+        server: z.ZodOptional<z.ZodObject<{
+            host: z.ZodString;
+            port: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            host: string;
+            port: number;
+        }, {
+            host: string;
+            port: number;
+        }>>;
+        llm: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            baseUrl: z.ZodOptional<z.ZodString>;
+            apiKey: z.ZodOptional<z.ZodString>;
+            models: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                baseUrl: z.ZodString;
+                apiKey: z.ZodString;
+                temperature: z.ZodOptional<z.ZodNumber>;
+                maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+                timeoutMs: z.ZodOptional<z.ZodNumber>;
+            }, "strict", z.ZodTypeAny, {
+                baseUrl: string;
+                apiKey: string;
+                temperature?: number | undefined;
+                timeoutMs?: number | undefined;
+                maxOutputTokens?: number | undefined;
+            }, {
+                baseUrl: string;
+                apiKey: string;
+                temperature?: number | undefined;
+                timeoutMs?: number | undefined;
+                maxOutputTokens?: number | undefined;
+            }>>>;
+        }, "strict", z.ZodTypeAny, {
+            models?: Record<string, {
+                baseUrl: string;
+                apiKey: string;
+                temperature?: number | undefined;
+                timeoutMs?: number | undefined;
+                maxOutputTokens?: number | undefined;
+            }> | undefined;
+            baseUrl?: string | undefined;
+            apiKey?: string | undefined;
+        }, {
+            models?: Record<string, {
+                baseUrl: string;
+                apiKey: string;
+                temperature?: number | undefined;
+                timeoutMs?: number | undefined;
+                maxOutputTokens?: number | undefined;
+            }> | undefined;
+            baseUrl?: string | undefined;
+            apiKey?: string | undefined;
+        }>, {
+            models?: Record<string, {
+                baseUrl: string;
+                apiKey: string;
+                temperature?: number | undefined;
+                timeoutMs?: number | undefined;
+                maxOutputTokens?: number | undefined;
+            }> | undefined;
+            baseUrl?: string | undefined;
+            apiKey?: string | undefined;
+        }, {
+            models?: Record<string, {
+                baseUrl: string;
+                apiKey: string;
+                temperature?: number | undefined;
+                timeoutMs?: number | undefined;
+                maxOutputTokens?: number | undefined;
+            }> | undefined;
+            baseUrl?: string | undefined;
+            apiKey?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        tools: {
+            mode: "mcp" | "http-debug";
+            localDirectory: string;
+            gatewayTransport: "mcp" | "http";
+        };
+        deploymentContext: "dev" | "desktop" | "server";
+        governance: {
+            enabled: boolean;
+        };
+        storage: {
+            profile: "dev" | "test" | "integration" | "production";
+            checkpointDir: string;
+        };
+        llm?: {
+            models?: Record<string, {
+                baseUrl: string;
+                apiKey: string;
+                temperature?: number | undefined;
+                timeoutMs?: number | undefined;
+                maxOutputTokens?: number | undefined;
+            }> | undefined;
+            baseUrl?: string | undefined;
+            apiKey?: string | undefined;
+        } | undefined;
+        server?: {
+            host: string;
+            port: number;
+        } | undefined;
+        builtins?: {
+            timeoutMs?: number | undefined;
+            enabled?: boolean | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxReadBytes?: number | undefined;
+            maxOutputBytes?: number | undefined;
+            envAllowlist?: string[] | undefined;
+        } | undefined;
+    }, {
+        tools: {
+            mode: "mcp" | "http-debug";
+            localDirectory: string;
+            gatewayTransport: "mcp" | "http";
+        };
+        deploymentContext: "dev" | "desktop" | "server";
+        governance: {
+            enabled: boolean;
+        };
+        storage: {
+            profile: "dev" | "test" | "integration" | "production";
+            checkpointDir: string;
+        };
+        llm?: {
+            models?: Record<string, {
+                baseUrl: string;
+                apiKey: string;
+                temperature?: number | undefined;
+                timeoutMs?: number | undefined;
+                maxOutputTokens?: number | undefined;
+            }> | undefined;
+            baseUrl?: string | undefined;
+            apiKey?: string | undefined;
+        } | undefined;
+        server?: {
+            host: string;
+            port: number;
+        } | undefined;
+        builtins?: {
+            timeoutMs?: number | undefined;
+            enabled?: boolean | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxReadBytes?: number | undefined;
+            maxOutputBytes?: number | undefined;
+            envAllowlist?: string[] | undefined;
+        } | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    version: string;
+    platform: {
+        portalUrl: string;
+        foundationServiceUrl?: string | null | undefined;
+    };
+    runtime: {
+        tools: {
+            mode: "mcp" | "http-debug";
+            localDirectory: string;
+            gatewayTransport: "mcp" | "http";
+        };
+        deploymentContext: "dev" | "desktop" | "server";
+        governance: {
+            enabled: boolean;
+        };
+        storage: {
+            profile: "dev" | "test" | "integration" | "production";
+            checkpointDir: string;
+        };
+        llm?: {
+            models?: Record<string, {
+                baseUrl: string;
+                apiKey: string;
+                temperature?: number | undefined;
+                timeoutMs?: number | undefined;
+                maxOutputTokens?: number | undefined;
+            }> | undefined;
+            baseUrl?: string | undefined;
+            apiKey?: string | undefined;
+        } | undefined;
+        server?: {
+            host: string;
+            port: number;
+        } | undefined;
+        builtins?: {
+            timeoutMs?: number | undefined;
+            enabled?: boolean | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxReadBytes?: number | undefined;
+            maxOutputBytes?: number | undefined;
+            envAllowlist?: string[] | undefined;
+        } | undefined;
+    };
+    localToolDirectories?: string[] | undefined;
+    localSkillDirectories?: string[] | undefined;
+}, {
+    version: string;
+    platform: {
+        portalUrl: string;
+        foundationServiceUrl?: string | null | undefined;
+    };
+    runtime: {
+        tools: {
+            mode: "mcp" | "http-debug";
+            localDirectory: string;
+            gatewayTransport: "mcp" | "http";
+        };
+        deploymentContext: "dev" | "desktop" | "server";
+        governance: {
+            enabled: boolean;
+        };
+        storage: {
+            profile: "dev" | "test" | "integration" | "production";
+            checkpointDir: string;
+        };
+        llm?: {
+            models?: Record<string, {
+                baseUrl: string;
+                apiKey: string;
+                temperature?: number | undefined;
+                timeoutMs?: number | undefined;
+                maxOutputTokens?: number | undefined;
+            }> | undefined;
+            baseUrl?: string | undefined;
+            apiKey?: string | undefined;
+        } | undefined;
+        server?: {
+            host: string;
+            port: number;
+        } | undefined;
+        builtins?: {
+            timeoutMs?: number | undefined;
+            enabled?: boolean | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxReadBytes?: number | undefined;
+            maxOutputBytes?: number | undefined;
+            envAllowlist?: string[] | undefined;
+        } | undefined;
+    };
+    localToolDirectories?: string[] | undefined;
+    localSkillDirectories?: string[] | undefined;
+}>;
+export type EapProjectConfig = z.infer<typeof EapProjectConfigSchema>;
+/** 生成 eap.config.json.version 与当前 SDK 不一致时的可执行引导信息。 */
+export declare function projectConfigVersionMismatchMessage(actual: string): string;
+/**
+ * 解析项目配置。version 不一致时抛出带引导信息的错误；
+ * 其他校验失败时输出易读的 `field: message` 文本，而不是 Zod 的原始 JSON。
+ */
+export declare function parseProjectConfig(input: unknown): EapProjectConfig;
+//# sourceMappingURL=project-config.d.ts.map

package/dist/schema/project-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/schema/project-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsCxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCK,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,uDAAuD;AACvD,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAcnE"}

package/dist/schema/project-config.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { SDK_VERSION } from '../version.js';
+const RuntimeServerSchema = z.object({
+    host: z.string().min(1).describe('SDK 本地 Agent 服务的监听主机名，映射至 EAP_RUNTIME_HOST。'),
+    port: z.number().int().min(1).max(65535).describe('SDK 本地 Agent 服务的监听端口，映射至 EAP_RUNTIME_PORT。'),
+}).strict().describe('SDK 本地 Agent 服务的可选监听配置。');
+const LlmConnectionSchema = z.object({
+    baseUrl: z.string().url().describe('该模型的 OpenAI 兼容网关地址。'),
+    apiKey: z.string().min(1).describe('该模型的密钥，或 ${ENV_VAR}。'),
+    temperature: z.number().min(0).max(2).optional().describe('本地缺省温度；图 llm 节点可覆盖。对应 ModelRecord.defaults.temperature。'),
+    maxOutputTokens: z.number().int().positive().optional().describe('本地缺省 max_tokens；图 llm 节点可覆盖。对应 ModelRecord.defaults.maxOutputTokens。'),
+    timeoutMs: z.number().int().min(1_000).max(3_600_000).optional().describe('该模型 HttpLLMProvider 超时毫秒；缺省 180000。写入 EAP_LLM_CONNECTIONS.byModel[].timeoutMs。'),
+}).strict().describe('单个模型的本地网关。');
+const RuntimeLlmSchema = z.object({
+    baseUrl: z.string().url().optional().describe('未单独配置的模型使用的默认网关，映射至 OPENAI_BASE_URL。'),
+    apiKey: z.string().min(1).optional().describe('默认密钥，或 ${ENV_VAR}。映射至 OPENAI_API_KEY。'),
+    models: z.record(LlmConnectionSchema).optional().describe('按模型名配置本地可连接的网关和密钥。键区分大小写、原样保留；可包含未被当前 Agent 声明的模型。'),
+}).strict().superRefine((value, context) => {
+    const hasDefault = Boolean(value.baseUrl && value.apiKey);
+    const hasModels = Boolean(value.models && Object.keys(value.models).length > 0);
+    if (!hasDefault && !hasModels) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'runtime.llm 需要同时配置 baseUrl+apiKey，或至少配置一个 models.<name>',
+        });
+    }
+    if (Boolean(value.baseUrl) !== Boolean(value.apiKey)) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'runtime.llm.baseUrl 与 runtime.llm.apiKey 必须成对配置',
+        });
+    }
+}).describe('本地 LLM 直连。deploymentContext=dev 时生效，生产不读。');
+export const EapProjectConfigSchema = z.object({
+    version: z.string().refine((value) => value === SDK_VERSION, { message: `项目配置 version 必须与 @gt-fe/eap-sdk ${SDK_VERSION} 一致。` }).describe('项目使用的 @gt-fe/eap-sdk 版本，必须与当前安装版本严格一致。'),
+    localToolDirectories: z.array(z.string().min(1)).optional()
+        .describe('本地 Tool 父目录列表；相对路径基于项目根目录解析，物化时仅扫描直接子目录。'),
+    localSkillDirectories: z.array(z.string().min(1)).optional()
+        .describe('本地 Skill 父目录列表；相对路径基于项目根目录解析，物化时仅扫描直接子目录。'),
+    platform: z.object({
+        foundationServiceUrl: z.string().url().or(z.literal('')).nullish().describe('Agent 最终部署后访问的服务托管地址，映射至 FOUNDATION_SERVICE_URL；可省略、为空或为 null。null 或空字符串用于显式清空默认地址。'),
+        portalUrl: z.string().url().describe('开发者平台 Portal 地址，映射至 EAP_PLATFORM_ENDPOINT。'),
+    }).strict().describe('服务托管与开发者 Portal 地址配置。'),
+    runtime: z.object({
+        deploymentContext: z.enum(['dev', 'desktop', 'server']).describe('部署上下文，可选 dev、desktop 或 server，映射至 EAP_DEPLOYMENT_CONTEXT。'),
+        governance: z.object({
+            enabled: z.boolean().describe('是否启用治理，映射至 GOVERNANCE_DISABLED；false 映射为 1，true 映射为 0。'),
+        }).strict().describe('运行时治理配置。'),
+        storage: z.object({
+            profile: z.enum(['test', 'dev', 'integration', 'production']).describe('运行时存储配置档，可选 test、dev、integration 或 production，映射至 EAP_RUNTIME_STORAGE_PROFILE。'),
+            checkpointDir: z.string().min(1).describe('检查点目录的相对路径，相对于项目根目录，映射至 EAP_CHECKPOINT_DIR。'),
+        }).strict().describe('运行时存储与检查点配置。'),
+        tools: z.object({
+            mode: z.enum(['mcp', 'http-debug']).describe('工具执行模式，可选 mcp 或 http-debug，默认 mcp，映射至 EAP_TOOL_EXECUTION_MODE。'),
+            localDirectory: z.string().min(1).describe('本地工具目录的相对路径，相对于项目根目录，映射至 EAP_LOCAL_TOOLS_DIR。'),
+            gatewayTransport: z.enum(['mcp', 'http']).describe('工具网关传输协议，可选 mcp 或 http，映射至 EAP_TOOL_GATEWAY_TRANSPORT。'),
+        }).strict().describe('运行时工具执行配置。'),
+        builtins: z.object({
+            enabled: z.boolean().optional().describe('是否注入平台内置 read_file/write_file/execute_command。false 映射 EAP_DISABLE_BUILTIN_TOOLS=1。'),
+            timeoutMs: z.number().int().min(1_000).max(3_600_000).optional().describe('execute_command 默认超时毫秒，默认 120000。映射 EAP_BUILTIN_TIMEOUT_MS。'),
+            maxTimeoutMs: z.number().int().min(1_000).max(3_600_000).optional().describe('execute_command 超时上限毫秒，默认 600000。映射 EAP_BUILTIN_MAX_TIMEOUT_MS。'),
+            maxReadBytes: z.number().int().positive().optional().describe('read_file 字节上限，默认 1048576。映射 EAP_BUILTIN_MAX_READ_BYTES。'),
+            maxOutputBytes: z.number().int().positive().optional().describe('命令 stdout/stderr 各自上限，默认 262144。映射 EAP_BUILTIN_MAX_OUTPUT_BYTES。'),
+            envAllowlist: z.array(z.string().min(1)).optional().describe('额外允许继承的环境变量名，逗号写入 EAP_BUILTIN_ENV_ALLOWLIST。不含密钥。'),
+        }).strict().optional().describe('平台内置文件/命令工具限额。省略则用 Runtime 默认（超时 120s）。'),
+        server: RuntimeServerSchema.optional().describe('SDK 本地 Agent 服务的可选配置。'),
+        llm: RuntimeLlmSchema.optional().describe('本地模型网关。仅 deploymentContext=dev 映射到 Runtime。'),
+    }).strict().describe('运行时配置。'),
+}).strict().describe('EAP 项目配置文件的完整结构。');
+/** 生成 eap.config.json.version 与当前 SDK 不一致时的可执行引导信息。 */
+export function projectConfigVersionMismatchMessage(actual) {
+    return (`eap.config.json 的 version 为 ${actual}，与当前安装的 @gt-fe/eap-sdk ${SDK_VERSION} 不一致。` +
+        `请将 eap.config.json 的 version 更新为 ${SDK_VERSION}（或调整 @gt-fe/eap-sdk 依赖版本以匹配）。`);
+}
+/**
+ * 解析项目配置。version 不一致时抛出带引导信息的错误；
+ * 其他校验失败时输出易读的 `field: message` 文本，而不是 Zod 的原始 JSON。
+ */
+export function parseProjectConfig(input) {
+    const version = readVersionField(input);
+    if (typeof version === 'string' && version !== SDK_VERSION) {
+        throw new Error(projectConfigVersionMismatchMessage(version));
+    }
+    const parsed = EapProjectConfigSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new Error(parsed.error.issues
+            .map((issue) => `${issue.path.join('.') || '<root>'}: ${issue.message}`)
+            .join('; '));
+    }
+    return parsed.data;
+}
+function readVersionField(input) {
+    if (typeof input !== 'object' || input === null)
+        return undefined;
+    return input.version;
+}
+//# sourceMappingURL=project-config.js.map

package/dist/schema/project-config.js.map

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

package/dist/schema/skill/index.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const SkillIdSchema: z.ZodString;
+export declare const SkillCodeSchema: z.ZodString;
+export declare const SkillVersionSchema: z.ZodString;
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/skill/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa,aAIyC,CAAC;AAEpE,eAAO,MAAM,eAAe,aAAgB,CAAC;AAE7C,eAAO,MAAM,kBAAkB,aAEgD,CAAC"}

package/dist/schema/skill/index.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export const SkillIdSchema = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z0-9][a-z0-9_-]*$/, 'Skill code 只能包含小写字母、数字、连字符和下划线');
+export const SkillCodeSchema = SkillIdSchema;
+export const SkillVersionSchema = z
+    .string()
+    .regex(/^\d+\.\d+\.\d+$/, 'Skill version 必须使用 major.minor.patch 格式（如 1.2.3）');
+//# sourceMappingURL=index.js.map

package/dist/schema/skill/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CAAC,uBAAuB,EAAE,gCAAgC,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAE7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,EAAE;KACR,KAAK,CAAC,iBAAiB,EAAE,kDAAkD,CAAC,CAAC"}

package/dist/schema/toolset/index.d.ts

@@ -0,0 +1,3 @@
+export * from './manifest.js';
+export * from './read-toolset-manifest.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/toolset/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/toolset/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC"}

package/dist/schema/toolset/index.js

@@ -0,0 +1,3 @@
+export * from './manifest.js';
+export * from './read-toolset-manifest.js';
+//# sourceMappingURL=index.js.map

package/dist/schema/toolset/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema/toolset/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC"}