@gt-fe/eap-runtime 0.0.8

package/dist/providers/routing-llm-provider.js

@@ -0,0 +1,79 @@
+/**
+ * RoutingLLMProvider — 基于 Foundation Service 模型路由的 LLM Provider
+ *
+ * 工作流程：
+ * 1. 请求 Foundation `/models/select` 选择最佳模型
+ * 2. Foundation 返回模型名称 + Provider 连接配置（baseUrl/apiKey/headers）
+ * 3. 用返回的连接配置创建 HttpLLMProvider，发送请求
+ *
+ * 设计原则：
+ * - Runtime 不存任何 LLM 凭证，全部从 Foundation 获取
+ * - 支持任意 OpenAI 兼容 API（OpenAI / DeepSeek / 本地 Ollama 等）
+ * - 连接配置由 Foundation 统一管理，Runtime 无感知
+ */
+import { EchoLLMProvider } from './echo-llm-provider.js';
+import { HttpLLMProvider } from './http-llm-provider.js';
+export class RoutingLLMProvider {
+    foundationUrl;
+    fallback;
+    constructor(config) {
+        this.foundationUrl = config.foundationUrl.replace(/\/$/, '');
+        this.fallback = config.fallbackProvider ?? new EchoLLMProvider();
+    }
+    async invoke(messages, config) {
+        const selected = await this.selectModel(config);
+        const provider = this.createProviderForModel(selected);
+        return provider.invoke(messages, { ...config, model: selected.name });
+    }
+    async *stream(messages, config) {
+        const selected = await this.selectModel(config);
+        const provider = this.createProviderForModel(selected);
+        yield* provider.stream(messages, { ...config, model: selected.name });
+    }
+    async selectModel(config) {
+        try {
+            const res = await fetch(`${this.foundationUrl}/api/v1/models/select`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    preferredModel: config.model,
+                    capabilities: { chat: true, functionCalling: true },
+                }),
+            });
+            if (res.ok) {
+                const body = await res.json();
+                if (body.data?.name) {
+                    return {
+                        name: body.data.name,
+                        provider: body.data.provider,
+                        connection: body.data.connection ?? null,
+                    };
+                }
+            }
+        }
+        catch {
+            // fallback to local
+        }
+        return { name: config.model ?? 'echo', provider: 'local', connection: null };
+    }
+    createProviderForModel(selected) {
+        // 优先使用 Foundation 返回的连接配置
+        if (selected.connection) {
+            return new HttpLLMProvider({
+                apiKey: selected.connection.apiKey ?? '',
+                baseUrl: selected.connection.baseUrl,
+                defaultModel: selected.name,
+                timeoutMs: selected.connection.timeoutMs,
+            });
+        }
+        // Fallback: 兼容旧逻辑（直接读 env）—— 开发环境快速启动用
+        if (process.env.OPENAI_API_KEY && selected.provider === 'openai') {
+            return new HttpLLMProvider({
+                apiKey: process.env.OPENAI_API_KEY,
+                baseUrl: process.env.OPENAI_BASE_URL,
+                defaultModel: selected.name,
+            });
+        }
+        return this.fallback;
+    }
+}

package/dist/registry/agent-models.d.ts

@@ -0,0 +1 @@
+export { resolveDeclaredModels, resolveAgentPrimaryModel, resolveAgentModelAllowlist, } from '@gt-fe/eap-contracts';

package/dist/registry/agent-models.js

@@ -0,0 +1 @@
+export { resolveDeclaredModels, resolveAgentPrimaryModel, resolveAgentModelAllowlist, } from '@gt-fe/eap-contracts';

package/dist/registry/agent-registry-client.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Agent Registry 客户端 — 从 foundation-service 拉取 Agent 定义
+ */
+/** Agent 清单（与 @gt-fe/eap-contracts AgentManifest 对齐） */
+export interface AgentManifest {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    mode: string;
+    tools: string[];
+    skills: string[];
+    prompts: Record<string, string>;
+    models?: {
+        primary: string;
+        alternatives?: string[];
+    };
+    config?: {
+        timeout?: number;
+        retryCount?: number;
+    };
+    metadata: {
+        owner: string;
+        tags?: string[];
+        category?: string;
+        graph?: Record<string, unknown>;
+    };
+    graph?: Record<string, unknown>;
+}
+export interface AgentRegistryClientConfig {
+    baseUrl: string;
+    timeout?: number;
+}
+export interface AgentRegistryRecord {
+    id: string;
+    name: string;
+    version: string;
+    status: string;
+    mode: string;
+    manifest: AgentManifest & {
+        graph?: unknown;
+    };
+}
+export declare function createAgentRegistryClient(config: AgentRegistryClientConfig): {
+    getAgent(agentCode: string): Promise<AgentRegistryRecord | null>;
+    getToolByName(toolName: string): Promise<ToolRegistryRecord | null>;
+};
+export type AgentRegistryClient = ReturnType<typeof createAgentRegistryClient>;
+/** Registry Tool 记录（运行期拉取，manifest 保留扩展字段如 http） */
+export interface ToolRegistryRecord {
+    id: string;
+    name: string;
+    version: string;
+    status: string;
+    manifest: Record<string, unknown>;
+}

package/dist/registry/agent-registry-client.js

@@ -0,0 +1,36 @@
+/**
+ * Agent Registry 客户端 — 从 foundation-service 拉取 Agent 定义
+ */
+export function createAgentRegistryClient(config) {
+    const { baseUrl, timeout = 5000 } = config;
+    async function request(path) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(`${baseUrl}${path}`, {
+                signal: controller.signal,
+                headers: { Accept: 'application/json' },
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const data = await response.json();
+            return data.data ?? data;
+        }
+        catch {
+            return null;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    return {
+        async getAgent(agentCode) {
+            return request(`/api/v1/agents/${agentCode}`);
+        },
+        async getToolByName(toolName) {
+            const result = await request(`/api/v1/tools?search=${encodeURIComponent(toolName)}&pageSize=50`);
+            return result?.items?.find((t) => t.name === toolName) ?? null;
+        },
+    };
+}

package/dist/registry/definition-cache.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 预装可执行定义进程内缓存（会议目标态：上线 load 后请求命中内存）
+ *
+ * 缓存 Graph DSL / Tool / Skill 定义；不缓存已编译 StateGraph 实例
+ *（每次请求仍 buildGraph，避免可变状态串扰）。
+ */
+import type { GraphDSL } from '../graph/contracts/executable-graph.js';
+import type { LoadedToolDefinition } from '../tool/loaded-tool-definition.js';
+import type { LoadedSkillInfo } from '../tool/system-prompt-builder.js';
+export interface CachedAgentDefinitions {
+    /** undefined = 尚未缓存 graph */
+    graph?: GraphDSL;
+    /** undefined = 尚未缓存 tools；空数组表示已缓存且无 tool */
+    tools?: LoadedToolDefinition[];
+    /** userId → skills；无用户层时键为 ''；缺键表示该 user 视角未缓存 */
+    skillsByUser: Map<string, {
+        skills: LoadedSkillInfo[];
+        stamp: string;
+    }>;
+    warmedAt: number;
+}
+export declare function cacheKey(agentCode: string, agentVersion?: string): string;
+export declare function skillUserKey(userId?: string): string;
+export declare class PreinstallDefinitionCache {
+    private readonly store;
+    private ensure;
+    get(agentCode: string, agentVersion?: string): CachedAgentDefinitions | undefined;
+    setGraph(agentCode: string, agentVersion: string | undefined, graph: GraphDSL): void;
+    setTools(agentCode: string, agentVersion: string | undefined, tools: LoadedToolDefinition[]): void;
+    setSkills(agentCode: string, agentVersion: string | undefined, userId: string | undefined, skills: LoadedSkillInfo[], stamp?: string): void;
+    getSkills(agentCode: string, agentVersion: string | undefined, userId?: string, expectedStamp?: string): LoadedSkillInfo[] | undefined;
+    invalidate(agentCode: string, agentVersion?: string): void;
+    invalidateAll(): void;
+    size(): number;
+}
+/** 解析定义缓存开关：有预装时默认开；EAP_PRELOAD_DEFINITION_CACHE=0 关闭 */
+export declare function resolveDefinitionCacheEnabled(hasPreinstall: boolean, explicit?: boolean): boolean;

package/dist/registry/definition-cache.js

@@ -0,0 +1,82 @@
+/**
+ * 预装可执行定义进程内缓存（会议目标态：上线 load 后请求命中内存）
+ *
+ * 缓存 Graph DSL / Tool / Skill 定义；不缓存已编译 StateGraph 实例
+ *（每次请求仍 buildGraph，避免可变状态串扰）。
+ */
+export function cacheKey(agentCode, agentVersion) {
+    return `${agentCode}@${agentVersion ?? 'auto'}`;
+}
+export function skillUserKey(userId) {
+    return userId?.trim() ? userId.trim() : '';
+}
+export class PreinstallDefinitionCache {
+    store = new Map();
+    ensure(agentCode, agentVersion) {
+        const key = cacheKey(agentCode, agentVersion);
+        let existing = this.store.get(key);
+        if (!existing) {
+            existing = { skillsByUser: new Map(), warmedAt: Date.now() };
+            this.store.set(key, existing);
+        }
+        return existing;
+    }
+    get(agentCode, agentVersion) {
+        return this.store.get(cacheKey(agentCode, agentVersion));
+    }
+    setGraph(agentCode, agentVersion, graph) {
+        const entry = this.ensure(agentCode, agentVersion);
+        entry.graph = graph;
+        entry.warmedAt = Date.now();
+    }
+    setTools(agentCode, agentVersion, tools) {
+        const entry = this.ensure(agentCode, agentVersion);
+        entry.tools = tools;
+        entry.warmedAt = Date.now();
+    }
+    setSkills(agentCode, agentVersion, userId, skills, stamp = '') {
+        const entry = this.ensure(agentCode, agentVersion);
+        entry.skillsByUser.set(skillUserKey(userId), { skills, stamp });
+        entry.warmedAt = Date.now();
+    }
+    getSkills(agentCode, agentVersion, userId, expectedStamp) {
+        const entry = this.store.get(cacheKey(agentCode, agentVersion));
+        if (!entry)
+            return undefined;
+        const cached = entry.skillsByUser.get(skillUserKey(userId));
+        if (!cached)
+            return undefined;
+        if (expectedStamp !== undefined && cached.stamp !== expectedStamp)
+            return undefined;
+        return cached.skills;
+    }
+    invalidate(agentCode, agentVersion) {
+        if (agentVersion !== undefined) {
+            this.store.delete(cacheKey(agentCode, agentVersion));
+            return;
+        }
+        const prefix = `${agentCode}@`;
+        for (const key of [...this.store.keys()]) {
+            if (key.startsWith(prefix)) {
+                this.store.delete(key);
+            }
+        }
+    }
+    invalidateAll() {
+        this.store.clear();
+    }
+    size() {
+        return this.store.size;
+    }
+}
+/** 解析定义缓存开关：有预装时默认开；EAP_PRELOAD_DEFINITION_CACHE=0 关闭 */
+export function resolveDefinitionCacheEnabled(hasPreinstall, explicit) {
+    if (explicit !== undefined)
+        return explicit;
+    const v = process.env.EAP_PRELOAD_DEFINITION_CACHE;
+    if (v === '0' || v === 'false' || v === 'no')
+        return false;
+    if (v === '1' || v === 'true' || v === 'yes')
+        return true;
+    return hasPreinstall;
+}

package/dist/registry/deployment-snapshot.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Deployment 预装快照读取（RT-4 / 04 Req 8.1 / 联调契约）
+ *
+ * 目录（Agent 自包含，无全局共享层）：
+ *   {root}/agents/<agentCode>/<version>/preinstall/tools/<toolsetCode>/
+ *   {root}/agents/<agentCode>/<version>/preinstall/skills/<skillCode>/
+ *   {root}/agents/<agentCode>/<version>/users/<userId>/skills/<skillCode>/
+ *
+ * 命名：agentCode / toolsetCode / skillCode / toolName 均为语义化小写标识；
+ * Skill 目录无版本层（维护形态为 ZIP 上传整包替换，包内必含 skill.md）。
+ */
+export interface SnapshotToolRef {
+    toolId?: string;
+    name: string;
+    version?: string;
+    /** 可选：对应 tool.manifest.json 内容 sha256（小写 hex，可带 sha256: 前缀） */
+    sha256?: string;
+    /**
+     * 可选白名单：列出则仅启用所列子工具；省略 = 启用该 toolset 下全部子工具。
+     * @see agent.manifest toolRefs[].enabledTools
+     */
+    enabledTools?: string[];
+    /** 免 HITL 确认的子工具名（覆盖子工具 requireConfirmation） */
+    autoApprove?: string[];
+}
+export interface SnapshotSkillRef {
+    skillId: string;
+    name?: string;
+    version?: string;
+    description?: string;
+    /** 可选：对应 skill 清单文件内容 sha256 */
+    sha256?: string;
+}
+export interface AgentSnapshotMeta {
+    agentCode: string;
+    version: string;
+    tools?: SnapshotToolRef[];
+    skills?: SnapshotSkillRef[];
+    graph?: Record<string, unknown>;
+    agentDir: string;
+    manifest?: Record<string, unknown>;
+}
+export interface PreinstallToolManifest {
+    toolId: string;
+    name: string;
+    version: string;
+    manifest: Record<string, unknown>;
+    bundlePath: string;
+}
+export interface PreinstallSkillManifest {
+    skillId: string;
+    name: string;
+    version: string;
+    description?: string;
+    manifest: Record<string, unknown>;
+    bundlePath: string;
+}
+export interface DeploymentSnapshotOptions {
+    /** 强制校验 .ready；默认读 EAP_PRELOAD_REQUIRE_READY */
+    requireReady?: boolean;
+    /** snapshot 必须含 sha256 或 artifacts；默认 EAP_PRELOAD_REQUIRE_CHECKSUM */
+    requireChecksum?: boolean;
+}
+export interface IDeploymentSnapshot {
+    resolveAgentDir(agentCode: string, version?: string): Promise<string | null>;
+    loadAgentSnapshot(agentCode: string, version?: string): Promise<AgentSnapshotMeta | null>;
+    loadAgentManifest(agentDir: string): Promise<Record<string, unknown> | null>;
+    loadGraphDocument(agentDir: string, manifest?: Record<string, unknown> | null): Promise<Record<string, unknown> | null>;
+    loadToolManifest(ref: SnapshotToolRef, agentDir?: string | null): Promise<PreinstallToolManifest | null>;
+    loadSkillManifest(ref: SnapshotSkillRef, agentDir?: string | null, userId?: string, extraRoots?: string[]): Promise<PreinstallSkillManifest | null>;
+    assertReadyIfRequired(bundlePath: string, label: string): Promise<void>;
+    verifySnapshotIntegrity(agentDir: string, snap: Record<string, unknown>): Promise<void>;
+}
+/** 规范化摘要：去 sha256: 前缀、空白，转小写 hex */
+export declare function normalizeDigest(value: unknown): string | null;
+/**
+ * 装配引用（toolRefs / 简写 tools[]）vs 内联完整 ToolManifest。
+ * 含 type/execution 的视为内联定义；仅 toolset/name/version/enabledTools 等视为引用。
+ */
+export declare function isInlineToolDeclaration(item: unknown): boolean;
+/**
+ * 将 agent.manifest.toolRefs 上的 enabledTools/autoApprove 叠到 snapshot.tools[]（snapshot 未带时）。
+ */
+export declare function overlayToolRefPolicies(snapTools: SnapshotToolRef[], manifest?: Record<string, unknown>): SnapshotToolRef[];
+export declare class FileSystemDeploymentSnapshot implements IDeploymentSnapshot {
+    private readonly root;
+    private readonly flags;
+    constructor(root: string, options?: DeploymentSnapshotOptions);
+    private get requireReady();
+    assertReadyIfRequired(bundlePath: string, label: string): Promise<void>;
+    verifySnapshotIntegrity(agentDir: string, snap: Record<string, unknown>): Promise<void>;
+    resolveAgentDir(agentCode: string, version?: string): Promise<string | null>;
+    loadAgentManifest(agentDir: string): Promise<Record<string, unknown> | null>;
+    loadGraphDocument(agentDir: string, manifest?: Record<string, unknown> | null): Promise<Record<string, unknown> | null>;
+    loadAgentSnapshot(agentCode: string, version?: string): Promise<AgentSnapshotMeta | null>;
+    loadToolManifest(ref: SnapshotToolRef, agentDir?: string | null): Promise<PreinstallToolManifest | null>;
+    loadSkillManifest(ref: SnapshotSkillRef, agentDir?: string | null, userId?: string, extraRoots?: string[]): Promise<PreinstallSkillManifest | null>;
+}
+export declare function createDeploymentSnapshotFromEnv(explicitRoot?: string, options?: DeploymentSnapshotOptions): FileSystemDeploymentSnapshot | undefined;