@gt-fe/eap-cli 0.2.11 → 0.2.12

package/dist/templates/agent-api-orchestration/src/http/shared/request.ts

@@ -1,82 +1,82 @@
-import type { Request } from 'express';
-import { randomUUID } from 'node:crypto';
-import type { AgentRequest } from '@gt-fe/eap-sdk';
-import type { AgentRequestBody } from '../types.js';
-import { badRequest } from '../errors.js';
-
-export function text(value: unknown): string | undefined {
-  return typeof value === 'string' && value.trim() ? value.trim() : undefined;
-}
-
-export function isRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value && typeof value === 'object' && !Array.isArray(value));
-}
-
-export function requestBody(request: Request): AgentRequestBody {
-  // 非 JSON 对象统一按空对象处理，具体字段校验由路由服务函数完成。
-  return isRecord(request.body) ? request.body as AgentRequestBody : {};
-}
-
-export function resolveSessionId(routeSessionId: string | undefined, bodySessionId: string | undefined): string | undefined {
-  if (routeSessionId && bodySessionId && routeSessionId !== bodySessionId) {
-    throw badRequest('Path sessionId and body sessionId must match');
-  }
-  return routeSessionId ?? bodySessionId;
-}
-
-export function buildAgentRequest(
-  request: Request,
-  body: AgentRequestBody,
-  sessionId?: string,
-): AgentRequest {
-  // 只组装 SDK AgentRequest，不解析 Authorization，也不构造用户身份上下文。
-  const correlationId = request.header('x-correlation-id')?.trim() || randomUUID();
-  const ragSources = stringArray(body.ragSources, 'ragSources');
-  const ragScope = parseRagScope(body.ragScope);
-  return {
-    ...(sessionId ? { sessionId } : {}),
-    ...(text(body.taskId) ? { taskId: text(body.taskId) } : {}),
-    ...(text(body.agentVersion) ? { agentVersion: text(body.agentVersion) } : {}),
-    // 服务层不伪造用户身份；关联 ID 仍然透传，方便宿主接入自己的日志和链路追踪。
-    traceId: text(body.traceId) ?? correlationId,
-    ...(isRecord(body.config) ? { config: body.config as AgentRequest['config'] } : {}),
-    ...(ragSources ? { ragSources } : {}),
-    ...(ragScope ? { ragScope } : {}),
-  };
-}
-
-export function pagination(request: Request): { limit?: number; offset?: number } {
-  const limit = queryInteger(request.query.limit, 'limit');
-  const offset = queryInteger(request.query.offset, 'offset');
-  if (limit !== undefined && (limit < 1 || limit > 500)) throw badRequest('limit must be an integer between 1 and 500');
-  return {
-    ...(limit !== undefined ? { limit } : {}),
-    ...(offset !== undefined ? { offset } : {}),
-  };
-}
-
-function queryInteger(value: unknown, name: string): number | undefined {
-  if (value === undefined || value === '') return undefined;
-  if (typeof value !== 'string' || !/^\d+$/.test(value)) throw badRequest(`${name} must be a non-negative integer`);
-  return Number(value);
-}
-
-function stringArray(value: unknown, name = 'value'): string[] | undefined {
-  if (value === undefined) return undefined;
-  if (!Array.isArray(value) || !value.every((item) => typeof item === 'string')) {
-    throw badRequest(`${name} must be an array of strings`);
-  }
-  return value as string[];
-}
-
-function parseRagScope(value: unknown): AgentRequest['ragScope'] {
-  if (value === undefined) return undefined;
-  if (!isRecord(value)) throw badRequest('ragScope must be an object');
-  const fileIds = stringArray(value.fileIds, 'ragScope.fileIds');
-  const dirPaths = stringArray(value.dirPaths, 'ragScope.dirPaths');
-  if (fileIds === undefined && dirPaths === undefined) return undefined;
-  return {
-    ...(fileIds ? { fileIds } : {}),
-    ...(dirPaths ? { dirPaths } : {}),
-  };
-}
+import type { Request } from 'express';
+import { randomUUID } from 'node:crypto';
+import type { AgentRequest } from '@gt-fe/eap-sdk';
+import type { AgentRequestBody } from '../types.js';
+import { badRequest } from '../errors.js';
+
+export function text(value: unknown): string | undefined {
+  return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+
+export function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+
+export function requestBody(request: Request): AgentRequestBody {
+  // 非 JSON 对象统一按空对象处理，具体字段校验由路由服务函数完成。
+  return isRecord(request.body) ? request.body as AgentRequestBody : {};
+}
+
+export function resolveSessionId(routeSessionId: string | undefined, bodySessionId: string | undefined): string | undefined {
+  if (routeSessionId && bodySessionId && routeSessionId !== bodySessionId) {
+    throw badRequest('Path sessionId and body sessionId must match');
+  }
+  return routeSessionId ?? bodySessionId;
+}
+
+export function buildAgentRequest(
+  request: Request,
+  body: AgentRequestBody,
+  sessionId?: string,
+): AgentRequest {
+  // 只组装 SDK AgentRequest，不解析 Authorization，也不构造用户身份上下文。
+  const correlationId = request.header('x-correlation-id')?.trim() || randomUUID();
+  const ragSources = stringArray(body.ragSources, 'ragSources');
+  const ragScope = parseRagScope(body.ragScope);
+  return {
+    ...(sessionId ? { sessionId } : {}),
+    ...(text(body.taskId) ? { taskId: text(body.taskId) } : {}),
+    ...(text(body.agentVersion) ? { agentVersion: text(body.agentVersion) } : {}),
+    // 服务层不伪造用户身份；关联 ID 仍然透传，方便宿主接入自己的日志和链路追踪。
+    traceId: text(body.traceId) ?? correlationId,
+    ...(isRecord(body.config) ? { config: body.config as AgentRequest['config'] } : {}),
+    ...(ragSources ? { ragSources } : {}),
+    ...(ragScope ? { ragScope } : {}),
+  };
+}
+
+export function pagination(request: Request): { limit?: number; offset?: number } {
+  const limit = queryInteger(request.query.limit, 'limit');
+  const offset = queryInteger(request.query.offset, 'offset');
+  if (limit !== undefined && (limit < 1 || limit > 500)) throw badRequest('limit must be an integer between 1 and 500');
+  return {
+    ...(limit !== undefined ? { limit } : {}),
+    ...(offset !== undefined ? { offset } : {}),
+  };
+}
+
+function queryInteger(value: unknown, name: string): number | undefined {
+  if (value === undefined || value === '') return undefined;
+  if (typeof value !== 'string' || !/^\d+$/.test(value)) throw badRequest(`${name} must be a non-negative integer`);
+  return Number(value);
+}
+
+function stringArray(value: unknown, name = 'value'): string[] | undefined {
+  if (value === undefined) return undefined;
+  if (!Array.isArray(value) || !value.every((item) => typeof item === 'string')) {
+    throw badRequest(`${name} must be an array of strings`);
+  }
+  return value as string[];
+}
+
+function parseRagScope(value: unknown): AgentRequest['ragScope'] {
+  if (value === undefined) return undefined;
+  if (!isRecord(value)) throw badRequest('ragScope must be an object');
+  const fileIds = stringArray(value.fileIds, 'ragScope.fileIds');
+  const dirPaths = stringArray(value.dirPaths, 'ragScope.dirPaths');
+  if (fileIds === undefined && dirPaths === undefined) return undefined;
+  return {
+    ...(fileIds ? { fileIds } : {}),
+    ...(dirPaths ? { dirPaths } : {}),
+  };
+}

package/dist/templates/agent-api-orchestration/src/http/shared/sse.ts

@@ -1,32 +1,32 @@
-import type { Response } from 'express';
-import type { SSEEvent } from '@gt-fe/eap-sdk';
-import { sendSseError } from '../errors.js';
-
-export function beginSse(response: Response): void {
-  // 关闭代理缓存和响应缓冲，确保前端能实时收到每一帧 Runtime 事件。
-  response.status(200).set({
-    'Content-Type': 'text/event-stream; charset=utf-8',
-    'Cache-Control': 'no-cache, no-transform',
-    Connection: 'keep-alive',
-    'X-Accel-Buffering': 'no',
-  }).flushHeaders();
-}
-
-export function writeSseEvent(response: Response, event: SSEEvent): void {
-  // 保留 Runtime 原始事件类型，只补充前端调试所需的公共追踪字段。
-  if (response.destroyed) return;
-  response.write(`event: ${event.type}\ndata: ${JSON.stringify({ ...event.data, correlationId: event.correlationId, taskId: event.taskId, timestamp: event.timestamp })}\n\n`);
-}
-
-export async function pipeSse(response: Response, events: AsyncIterable<SSEEvent>): Promise<void> {
-  // 客户端断开时停止消费 Runtime 流，避免继续向已关闭的连接写数据。
-  try {
-    for await (const event of events) {
-      if (response.destroyed) break;
-      writeSseEvent(response, event);
-    }
-    if (!response.destroyed) response.end();
-  } catch (error) {
-    sendSseError(response, error);
-  }
-}
+import type { Response } from 'express';
+import type { SSEEvent } from '@gt-fe/eap-sdk';
+import { sendSseError } from '../errors.js';
+
+export function beginSse(response: Response): void {
+  // 关闭代理缓存和响应缓冲，确保前端能实时收到每一帧 Runtime 事件。
+  response.status(200).set({
+    'Content-Type': 'text/event-stream; charset=utf-8',
+    'Cache-Control': 'no-cache, no-transform',
+    Connection: 'keep-alive',
+    'X-Accel-Buffering': 'no',
+  }).flushHeaders();
+}
+
+export function writeSseEvent(response: Response, event: SSEEvent): void {
+  // 保留 Runtime 原始事件类型，只补充前端调试所需的公共追踪字段。
+  if (response.destroyed) return;
+  response.write(`event: ${event.type}\ndata: ${JSON.stringify({ ...event.data, correlationId: event.correlationId, taskId: event.taskId, timestamp: event.timestamp })}\n\n`);
+}
+
+export async function pipeSse(response: Response, events: AsyncIterable<SSEEvent>): Promise<void> {
+  // 客户端断开时停止消费 Runtime 流，避免继续向已关闭的连接写数据。
+  try {
+    for await (const event of events) {
+      if (response.destroyed) break;
+      writeSseEvent(response, event);
+    }
+    if (!response.destroyed) response.end();
+  } catch (error) {
+    sendSseError(response, error);
+  }
+}

package/dist/templates/agent-api-orchestration/src/http/types.ts

@@ -1,39 +1,39 @@
-export interface AgentRequestBody {
-  // HTTP 层只做宽松的 unknown 接收，字段转换集中在 shared/request.ts。
-  input?: unknown;
-  content?: unknown;
-  id?: unknown;
-  userId?: unknown;
-  title?: unknown;
-  metadata?: unknown;
-  sessionId?: unknown;
-  taskId?: unknown;
-  agentVersion?: unknown;
-  traceId?: unknown;
-  config?: unknown;
-  /** RAG 会话勾选的数据源 id 列表（透传给 AgentRequest.ragSources）。 */
-  ragSources?: unknown;
-  /** RAG 本地检索范围（透传给 AgentRequest.ragScope）。 */
-  ragScope?: unknown;
-}
-
-export interface AgentHttpStartOptions {
-  host?: string;
-  port?: number;
-  corsOrigin?: string;
-  maxBodyBytes?: number;
-}
-
-export interface ResolvedAgentHttpOptions {
-  host: string;
-  port: number;
-  corsOrigin: string;
-  maxBodyBytes: number;
-}
-
-export interface AgentHttpService {
-  app: import('express').Express;
-  server: import('node:http').Server;
-  address: string;
-  stop(): Promise<void>;
-}
+export interface AgentRequestBody {
+  // HTTP 层只做宽松的 unknown 接收，字段转换集中在 shared/request.ts。
+  input?: unknown;
+  content?: unknown;
+  id?: unknown;
+  userId?: unknown;
+  title?: unknown;
+  metadata?: unknown;
+  sessionId?: unknown;
+  taskId?: unknown;
+  agentVersion?: unknown;
+  traceId?: unknown;
+  config?: unknown;
+  /** RAG 会话勾选的数据源 id 列表（透传给 AgentRequest.ragSources）。 */
+  ragSources?: unknown;
+  /** RAG 本地检索范围（透传给 AgentRequest.ragScope）。 */
+  ragScope?: unknown;
+}
+
+export interface AgentHttpStartOptions {
+  host?: string;
+  port?: number;
+  corsOrigin?: string;
+  maxBodyBytes?: number;
+}
+
+export interface ResolvedAgentHttpOptions {
+  host: string;
+  port: number;
+  corsOrigin: string;
+  maxBodyBytes: number;
+}
+
+export interface AgentHttpService {
+  app: import('express').Express;
+  server: import('node:http').Server;
+  address: string;
+  stop(): Promise<void>;
+}

package/dist/templates/agent-api-orchestration/src/index.ts

@@ -1,91 +1,91 @@
-import { config } from 'dotenv';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { createEmbeddedAgent } from './embedded-agent.js';
-import { startAgentHttpServer, type AgentHttpStartOptions } from './http/index.js';
-import { createAgentResourceService, type AgentResourceService } from './http/services/resource-service.js';
-export { createAgentApp, createAgentHttpServer, resolveAgentHttpStartOptions, startAgentHttpServer } from './http/index.js';
-export type { AgentHttpStartOptions } from './http/index.js';
-export { createEmbeddedAgent, createSdkTokenProvider } from './embedded-agent.js';
-export type { EmbeddedAgentOptions } from './embedded-agent.js';
-export { AgentResourceService, createAgentResourceService } from './http/services/resource-service.js';
-export type { ResourceApplyAndReloadResult } from './http/services/resource-service.js';
-
-// 入口文件的位置决定 Runtime 的相对路径，不依赖启动命令所在的当前目录。
-const entryDirectory = dirname(fileURLToPath(import.meta.url));
-const projectRoot = resolve(entryDirectory, '..');
-// 统一读取项目根 .env。
-config({ path: resolve(projectRoot, '.env') });
-
-// 默认导出实例用于模板开发演示（npm run dev）；生产宿主应调用
-// createEmbeddedAgent({ credentialProvider })，显式注入凭证。
-export const agent = await createEmbeddedAgent();
-
-// 资源服务只负责编排 SDK manager；生产宿主通过 createEmbeddedAgent({ resourceManager }) 注入。
-export const resourceService: AgentResourceService = createAgentResourceService(agent);
-
-// Agent 事件是 Runtime 的权威 SSEEvent；这里仅做实时观测，不持久化 Trace。
-const unsubscribe = agent.events.subscribe(undefined, (event) => {
-  console.log('[Agent 事件]', event.type, event.taskId, event.correlationId);
-});
-
-console.log(`Agent API 已加载：${agent.target.agentCode}@${agent.target.version}`);
-
-export function invoke(input: string, sessionId?: string) {
-  return agent.invoke(input, { sessionId });
-}
-
-export function stream(input: string, sessionId?: string) {
-  return agent.stream(input, {
-    sessionId,
-    onEvent(event) {
-      console.log('[流式事件]', event.type, event.taskId, event.correlationId);
-    },
-  });
-}
-
-// 会话和消息 API 同时以进程内函数导出；默认启动时由 Express 路由映射为 HTTP 接口。
-export function createSession(userId: string, title?: string) {
-  return agent.sessions.create({ userId, title });
-}
-
-export function listSessions(userId: string, limit = 20, offset = 0) {
-  return agent.sessions.list({ userId, limit, offset });
-}
-
-export function archiveSession(sessionId: string) {
-  return agent.sessions.archive(sessionId);
-}
-
-export function restoreSession(sessionId: string) {
-  return agent.sessions.restore(sessionId);
-}
-
-export function listMessages(sessionId: string, limit = 100, offset = 0) {
-  return agent.messages.list(sessionId, { limit, offset });
-}
-
-/** 启动面向前端智能体页面的 HTTP 服务；宿主也可以只 import Agent 自行挂载路由。 */
-export async function startAgentService(options: AgentHttpStartOptions = {}) {
-  return startAgentHttpServer(agent, options);
-}
-
-if (isDirectEntryPoint()) {
-  const service = await startAgentService();
-  console.log(`Agent 服务已启动：${service.address}`);
-  console.log(`能力描述：${service.address}/api/v1/agents/${agent.target.agentCode}`);
-
-  const shutdown = async () => {
-    unsubscribe();
-    await service.stop();
-    agent.dispose();
-  };
-  process.once('SIGINT', () => void shutdown());
-  process.once('SIGTERM', () => void shutdown());
-}
-
-function isDirectEntryPoint(): boolean {
-  const entry = process.argv[1];
-  return Boolean(entry && resolve(entry) === resolve(fileURLToPath(import.meta.url)));
-}
+import { config } from 'dotenv';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { createEmbeddedAgent } from './embedded-agent.js';
+import { startAgentHttpServer, type AgentHttpStartOptions } from './http/index.js';
+import { createAgentResourceService, type AgentResourceService } from './http/services/resource-service.js';
+export { createAgentApp, createAgentHttpServer, resolveAgentHttpStartOptions, startAgentHttpServer } from './http/index.js';
+export type { AgentHttpStartOptions } from './http/index.js';
+export { createEmbeddedAgent, createSdkTokenProvider } from './embedded-agent.js';
+export type { EmbeddedAgentOptions } from './embedded-agent.js';
+export { AgentResourceService, createAgentResourceService } from './http/services/resource-service.js';
+export type { ResourceApplyAndReloadResult } from './http/services/resource-service.js';
+
+// 入口文件的位置决定 Runtime 的相对路径，不依赖启动命令所在的当前目录。
+const entryDirectory = dirname(fileURLToPath(import.meta.url));
+const projectRoot = resolve(entryDirectory, '..');
+// 统一读取项目根 .env。
+config({ path: resolve(projectRoot, '.env') });
+
+// 默认导出实例用于模板开发演示（npm run dev）；生产宿主应调用
+// createEmbeddedAgent({ credentialProvider })，显式注入凭证。
+export const agent = await createEmbeddedAgent();
+
+// 资源服务只负责编排 SDK manager；生产宿主通过 createEmbeddedAgent({ resourceManager }) 注入。
+export const resourceService: AgentResourceService = createAgentResourceService(agent);
+
+// Agent 事件是 Runtime 的权威 SSEEvent；这里仅做实时观测，不持久化 Trace。
+const unsubscribe = agent.events.subscribe(undefined, (event) => {
+  console.log('[Agent 事件]', event.type, event.taskId, event.correlationId);
+});
+
+console.log(`Agent API 已加载：${agent.target.agentCode}@${agent.target.version}`);
+
+export function invoke(input: string, sessionId?: string) {
+  return agent.invoke(input, { sessionId });
+}
+
+export function stream(input: string, sessionId?: string) {
+  return agent.stream(input, {
+    sessionId,
+    onEvent(event) {
+      console.log('[流式事件]', event.type, event.taskId, event.correlationId);
+    },
+  });
+}
+
+// 会话和消息 API 同时以进程内函数导出；默认启动时由 Express 路由映射为 HTTP 接口。
+export function createSession(userId: string, title?: string) {
+  return agent.sessions.create({ userId, title });
+}
+
+export function listSessions(userId: string, limit = 20, offset = 0) {
+  return agent.sessions.list({ userId, limit, offset });
+}
+
+export function archiveSession(sessionId: string) {
+  return agent.sessions.archive(sessionId);
+}
+
+export function restoreSession(sessionId: string) {
+  return agent.sessions.restore(sessionId);
+}
+
+export function listMessages(sessionId: string, limit = 100, offset = 0) {
+  return agent.messages.list(sessionId, { limit, offset });
+}
+
+/** 启动面向前端智能体页面的 HTTP 服务；宿主也可以只 import Agent 自行挂载路由。 */
+export async function startAgentService(options: AgentHttpStartOptions = {}) {
+  return startAgentHttpServer(agent, options);
+}
+
+if (isDirectEntryPoint()) {
+  const service = await startAgentService();
+  console.log(`Agent 服务已启动：${service.address}`);
+  console.log(`能力描述：${service.address}/api/v1/agents/${agent.target.agentCode}`);
+
+  const shutdown = async () => {
+    unsubscribe();
+    await service.stop();
+    agent.dispose();
+  };
+  process.once('SIGINT', () => void shutdown());
+  process.once('SIGTERM', () => void shutdown());
+}
+
+function isDirectEntryPoint(): boolean {
+  const entry = process.argv[1];
+  return Boolean(entry && resolve(entry) === resolve(fileURLToPath(import.meta.url)));
+}

package/dist/templates/agent-api-orchestration/src/platform-user.ts

@@ -1,36 +1,36 @@
-import {
-  createPlatformClient,
-  type PlatformIdentity,
-} from '@gt-fe/eap-sdk';
-import { dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { loadTemplatePlatformConfig } from './project-config.js';
-
-/**
- * 演示宿主已经拿到前端用户 Token 时，如何通过 SDK 查询用户信息。
- *
- * 这个函数只做平台信息查询，不是 Express 中间件，也不会替宿主做登录、
- * 401 返回、租户绑定或业务权限判断。宿主可以在自己的路由层按需调用它。
- */
-export async function resolveTokenUser(token: string): Promise<PlatformIdentity> {
-  const requestToken = token.trim();
-  if (!requestToken) throw new Error('token 不能为空');
-
-  const { portalEndpoint, foundationEndpoint } = loadTemplatePlatformConfig(
-    dirname(fileURLToPath(import.meta.url)),
-  );
-  if (!foundationEndpoint) {
-    throw new Error('请在 eap.config.json 的 platform.foundationServiceUrl 中配置 Foundation 地址后再查询 Token 用户信息');
-  }
-
-  // PlatformClient 的 portalEndpoint 是必填配置；查询用户实际走 foundation。
-  const client = createPlatformClient({
-    portalEndpoint,
-    foundationEndpoint,
-    token: requestToken,
-  });
-
-  // SDK 会校验 Token 有效性、调用方类型，并返回 userId / roles / permissions。
-  return client.resolveTokenUser(requestToken);
-}
+import {
+  createPlatformClient,
+  type PlatformIdentity,
+} from '@gt-fe/eap-sdk';
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { loadTemplatePlatformConfig } from './project-config.js';
+
+/**
+ * 演示宿主已经拿到前端用户 Token 时，如何通过 SDK 查询用户信息。
+ *
+ * 这个函数只做平台信息查询，不是 Express 中间件，也不会替宿主做登录、
+ * 401 返回、租户绑定或业务权限判断。宿主可以在自己的路由层按需调用它。
+ */
+export async function resolveTokenUser(token: string): Promise<PlatformIdentity> {
+  const requestToken = token.trim();
+  if (!requestToken) throw new Error('token 不能为空');
+
+  const { portalEndpoint, foundationEndpoint } = loadTemplatePlatformConfig(
+    dirname(fileURLToPath(import.meta.url)),
+  );
+  if (!foundationEndpoint) {
+    throw new Error('请在 eap.config.json 的 platform.foundationServiceUrl 中配置 Foundation 地址后再查询 Token 用户信息');
+  }
+
+  // PlatformClient 的 portalEndpoint 是必填配置；查询用户实际走 foundation。
+  const client = createPlatformClient({
+    portalEndpoint,
+    foundationEndpoint,
+    token: requestToken,
+  });
+
+  // SDK 会校验 Token 有效性、调用方类型，并返回 userId / roles / permissions。
+  return client.resolveTokenUser(requestToken);
+}

package/dist/templates/agent-api-orchestration/src/project-config.ts

@@ -1,45 +1,45 @@
-import {
-  loadAgentRuntime,
-  type LoadedAgentRuntime,
-} from '@gt-fe/eap-sdk';
-import { resolve } from 'node:path';
-
-export interface TemplatePlatformConfig {
-  portalEndpoint: string;
-  foundationEndpoint?: string;
-}
-
-/**
- * Runtime preparation puts config and lock files beside the materialized
- * Agent manifest. Development and production therefore load the same tree.
- */
-export function loadTemplateRuntime(
-  moduleDirectory: string,
-  runtimeRoot?: string,
-): LoadedAgentRuntime {
-  return loadAgentRuntime({
-    runtimeRoot: runtimeRoot ?? resolveTemplateRuntimeRoot(moduleDirectory),
-  });
-}
-
-export function resolveTemplateRuntimeRoot(moduleDirectory: string): string {
-  const isDev = process.argv.includes('--dev');
-  const deploymentRoot = isDev ? resolve(moduleDirectory, '..') : moduleDirectory;
-  return resolve(
-    deploymentRoot,
-    process.env.EAP_RUNTIME_ROOT?.trim() || './.eap/runtime',
-  );
-}
-
-export function loadTemplatePlatformConfig(
-  moduleDirectory: string,
-  runtimeRoot?: string,
-): TemplatePlatformConfig {
-  const { config } = loadTemplateRuntime(moduleDirectory, runtimeRoot);
-  const portalEndpoint = config.platform.portalUrl.trim();
-  const foundationEndpoint = config.platform.foundationServiceUrl?.trim() || undefined;
-  return {
-    portalEndpoint,
-    ...(foundationEndpoint ? { foundationEndpoint } : {}),
-  };
-}
+import {
+  loadAgentRuntime,
+  type LoadedAgentRuntime,
+} from '@gt-fe/eap-sdk';
+import { resolve } from 'node:path';
+
+export interface TemplatePlatformConfig {
+  portalEndpoint: string;
+  foundationEndpoint?: string;
+}
+
+/**
+ * Runtime preparation puts config and lock files beside the materialized
+ * Agent manifest. Development and production therefore load the same tree.
+ */
+export function loadTemplateRuntime(
+  moduleDirectory: string,
+  runtimeRoot?: string,
+): LoadedAgentRuntime {
+  return loadAgentRuntime({
+    runtimeRoot: runtimeRoot ?? resolveTemplateRuntimeRoot(moduleDirectory),
+  });
+}
+
+export function resolveTemplateRuntimeRoot(moduleDirectory: string): string {
+  const isDev = process.argv.includes('--dev');
+  const deploymentRoot = isDev ? resolve(moduleDirectory, '..') : moduleDirectory;
+  return resolve(
+    deploymentRoot,
+    process.env.EAP_RUNTIME_ROOT?.trim() || './.eap/runtime',
+  );
+}
+
+export function loadTemplatePlatformConfig(
+  moduleDirectory: string,
+  runtimeRoot?: string,
+): TemplatePlatformConfig {
+  const { config } = loadTemplateRuntime(moduleDirectory, runtimeRoot);
+  const portalEndpoint = config.platform.portalUrl.trim();
+  const foundationEndpoint = config.platform.foundationServiceUrl?.trim() || undefined;
+  return {
+    portalEndpoint,
+    ...(foundationEndpoint ? { foundationEndpoint } : {}),
+  };
+}