@gt-fe/eap-cli 0.2.11 → 0.2.13

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

@@ -1,33 +1,33 @@
-import { Router } from 'express';
-import type { Agent } from '@gt-fe/eap-sdk';
-import { notFound } from '../errors.js';
-import { buildCapabilities } from '../services/agent-service.js';
-import { createInvocationRouter } from './invocations.js';
-import { createSessionRouter } from './sessions.js';
-
-export function createAgentRouter(agent: Agent): Router {
-  const router = Router({ mergeParams: true });
-
-  // 所有子路由共享同一个 Agent code 校验，避免错误 code 误调用当前 Agent。
-  router.use((request, _response, next) => {
-    if (request.params.agentCode !== agent.target.agentCode) return next(notFound('Agent not found'));
-    next();
-  });
-
-  // 能力描述是前端页面的入口：页面可先发现版本、模型、工具和接口地址。
-  router.get('/', (_request, response) => {
-    response.json(buildCapabilities(agent));
-  });
-
-  // 这里故意不放鉴权中间件。调用方可以在挂载本 Router 前注入自己的鉴权、租户和审计逻辑。
-  router.use(createInvocationRouter(agent));
-  router.use('/sessions', createSessionRouter(agent));
-  return router;
-}
-
-export function createAgentApiRouter(agent: Agent): Router {
-  const router = Router();
-  router.use('/:agentCode', createAgentRouter(agent));
-  router.use((_request, _response, next) => next(notFound()));
-  return router;
-}
+import { Router } from 'express';
+import type { Agent } from '@gt-fe/eap-sdk';
+import { notFound } from '../errors.js';
+import { buildCapabilities } from '../services/agent-service.js';
+import { createInvocationRouter } from './invocations.js';
+import { createSessionRouter } from './sessions.js';
+
+export function createAgentRouter(agent: Agent): Router {
+  const router = Router({ mergeParams: true });
+
+  // 所有子路由共享同一个 Agent code 校验，避免错误 code 误调用当前 Agent。
+  router.use((request, _response, next) => {
+    if (request.params.agentCode !== agent.target.agentCode) return next(notFound('Agent not found'));
+    next();
+  });
+
+  // 能力描述是前端页面的入口：页面可先发现版本、模型、工具和接口地址。
+  router.get('/', (_request, response) => {
+    response.json(buildCapabilities(agent));
+  });
+
+  // 这里故意不放鉴权中间件。调用方可以在挂载本 Router 前注入自己的鉴权、租户和审计逻辑。
+  router.use(createInvocationRouter(agent));
+  router.use('/sessions', createSessionRouter(agent));
+  return router;
+}
+
+export function createAgentApiRouter(agent: Agent): Router {
+  const router = Router();
+  router.use('/:agentCode', createAgentRouter(agent));
+  router.use((_request, _response, next) => next(notFound()));
+  return router;
+}

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

@@ -1,15 +1,15 @@
-import { Router } from 'express';
-import type { Agent } from '@gt-fe/eap-sdk';
-
-export function createHealthRouter(agent: Agent): Router {
-  const router = Router();
-  // 健康检查只报告进程和已加载 Agent 版本，不触发模型调用。
-  router.get('/', (_request, response) => {
-    response.json({
-      status: 'ok',
-      agentCode: agent.target.agentCode,
-      version: agent.target.version,
-    });
-  });
-  return router;
-}
+import { Router } from 'express';
+import type { Agent } from '@gt-fe/eap-sdk';
+
+export function createHealthRouter(agent: Agent): Router {
+  const router = Router();
+  // 健康检查只报告进程和已加载 Agent 版本，不触发模型调用。
+  router.get('/', (_request, response) => {
+    response.json({
+      status: 'ok',
+      agentCode: agent.target.agentCode,
+      version: agent.target.version,
+    });
+  });
+  return router;
+}

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

@@ -1,29 +1,29 @@
-import { Router } from 'express';
-import type { Agent } from '@gt-fe/eap-sdk';
-import { asyncRoute } from '../errors.js';
-import { messageInput } from '../services/agent-service.js';
-import { buildAgentRequest, requestBody, resolveSessionId, text } from '../shared/request.js';
-import { beginSse, pipeSse } from '../shared/sse.js';
-
-export function createInvocationRouter(agent: Agent): Router {
-  const router = Router({ mergeParams: true });
-
-  // 同步接口适合一次性拿完整结果；sessionId 可选，传入后由 Runtime 继续已有会话。
-  router.post('/invoke', asyncRoute(async (request, response) => {
-    const body = requestBody(request);
-    const sessionId = resolveSessionId(undefined, text(body.sessionId));
-    const input = messageInput(body as Record<string, unknown>);
-    response.json(await agent.invoke(input, buildAgentRequest(request, body, sessionId)));
-  }));
-
-  // 流式接口原样转发 Runtime SSEEvent，前端可以逐帧渲染模型和工具事件。
-  router.post('/stream', asyncRoute(async (request, response) => {
-    const body = requestBody(request);
-    const sessionId = resolveSessionId(undefined, text(body.sessionId));
-    const input = messageInput(body as Record<string, unknown>);
-    beginSse(response);
-    await pipeSse(response, agent.stream(input, buildAgentRequest(request, body, sessionId)));
-  }));
-
-  return router;
-}
+import { Router } from 'express';
+import type { Agent } from '@gt-fe/eap-sdk';
+import { asyncRoute } from '../errors.js';
+import { messageInput } from '../services/agent-service.js';
+import { buildAgentRequest, requestBody, resolveSessionId, text } from '../shared/request.js';
+import { beginSse, pipeSse } from '../shared/sse.js';
+
+export function createInvocationRouter(agent: Agent): Router {
+  const router = Router({ mergeParams: true });
+
+  // 同步接口适合一次性拿完整结果；sessionId 可选，传入后由 Runtime 继续已有会话。
+  router.post('/invoke', asyncRoute(async (request, response) => {
+    const body = requestBody(request);
+    const sessionId = resolveSessionId(undefined, text(body.sessionId));
+    const input = messageInput(body as Record<string, unknown>);
+    response.json(await agent.invoke(input, buildAgentRequest(request, body, sessionId)));
+  }));
+
+  // 流式接口原样转发 Runtime SSEEvent，前端可以逐帧渲染模型和工具事件。
+  router.post('/stream', asyncRoute(async (request, response) => {
+    const body = requestBody(request);
+    const sessionId = resolveSessionId(undefined, text(body.sessionId));
+    const input = messageInput(body as Record<string, unknown>);
+    beginSse(response);
+    await pipeSse(response, agent.stream(input, buildAgentRequest(request, body, sessionId)));
+  }));
+
+  return router;
+}

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

@@ -1,70 +1,70 @@
-import { Router } from 'express';
-import type { Agent } from '@gt-fe/eap-sdk';
-import { asyncRoute } from '../errors.js';
-import { getSessionOrThrow, messageInput } from '../services/agent-service.js';
-import { beginSse, pipeSse } from '../shared/sse.js';
-import { buildAgentRequest, isRecord, pagination, requestBody, resolveSessionId, text } from '../shared/request.js';
-
-export function createSessionRouter(agent: Agent): Router {
-  const router = Router({ mergeParams: true });
-
-  // userId 只是会话记录上的业务字段，宿主可在自己的鉴权层决定它的取值。
-  router.get('/', asyncRoute(async (request, response) => {
-    const queryUserId = text(request.query.userId);
-    response.json(await agent.sessions.list({
-      ...(queryUserId ? { userId: queryUserId } : {}),
-      ...pagination(request),
-    }));
-  }));
-
-  // 创建会话不绑定登录态，方便模板直接连接前端页面或由宿主传入用户 ID。
-  router.post('/', asyncRoute(async (request, response) => {
-    const body = requestBody(request);
-    const bodyUserId = text(body.userId);
-    response.status(201).json(await agent.sessions.create({
-      ...(text(body.id) ? { id: text(body.id) } : {}),
-      ...(bodyUserId ? { userId: bodyUserId } : {}),
-      ...(body.title !== undefined ? { title: text(body.title) ?? '' } : {}),
-      ...(isRecord(body.metadata) ? { metadata: body.metadata } : {}),
-    }));
-  }));
-
-  // 以下接口只负责会话和消息生命周期，不承担用户归属校验。
-  router.get('/:sessionId', asyncRoute(async (request, response) => {
-    response.json(await getSessionOrThrow(agent, request.params.sessionId));
-  }));
-
-  router.post('/:sessionId/archive', asyncRoute(async (request, response) => {
-    await getSessionOrThrow(agent, request.params.sessionId);
-    response.json(await agent.sessions.archive(request.params.sessionId));
-  }));
-
-  router.post('/:sessionId/restore', asyncRoute(async (request, response) => {
-    await getSessionOrThrow(agent, request.params.sessionId);
-    response.json(await agent.sessions.restore(request.params.sessionId));
-  }));
-
-  router.get('/:sessionId/messages', asyncRoute(async (request, response) => {
-    await getSessionOrThrow(agent, request.params.sessionId);
-    response.json(await agent.messages.list(request.params.sessionId, pagination(request)));
-  }));
-
-  router.post('/:sessionId/messages', asyncRoute(async (request, response) => {
-    const sessionId = request.params.sessionId;
-    await getSessionOrThrow(agent, sessionId);
-    const body = requestBody(request);
-    const input = messageInput(body as Record<string, unknown>);
-    response.json(await agent.invoke(input, buildAgentRequest(request, body, resolveSessionId(sessionId, text(body.sessionId)))));
-  }));
-
-  router.post('/:sessionId/stream', asyncRoute(async (request, response) => {
-    const sessionId = request.params.sessionId;
-    await getSessionOrThrow(agent, sessionId);
-    const body = requestBody(request);
-    const input = messageInput(body as Record<string, unknown>);
-    beginSse(response);
-    await pipeSse(response, agent.stream(input, buildAgentRequest(request, body, resolveSessionId(sessionId, text(body.sessionId)))));
-  }));
-
-  return router;
-}
+import { Router } from 'express';
+import type { Agent } from '@gt-fe/eap-sdk';
+import { asyncRoute } from '../errors.js';
+import { getSessionOrThrow, messageInput } from '../services/agent-service.js';
+import { beginSse, pipeSse } from '../shared/sse.js';
+import { buildAgentRequest, isRecord, pagination, requestBody, resolveSessionId, text } from '../shared/request.js';
+
+export function createSessionRouter(agent: Agent): Router {
+  const router = Router({ mergeParams: true });
+
+  // userId 只是会话记录上的业务字段，宿主可在自己的鉴权层决定它的取值。
+  router.get('/', asyncRoute(async (request, response) => {
+    const queryUserId = text(request.query.userId);
+    response.json(await agent.sessions.list({
+      ...(queryUserId ? { userId: queryUserId } : {}),
+      ...pagination(request),
+    }));
+  }));
+
+  // 创建会话不绑定登录态，方便模板直接连接前端页面或由宿主传入用户 ID。
+  router.post('/', asyncRoute(async (request, response) => {
+    const body = requestBody(request);
+    const bodyUserId = text(body.userId);
+    response.status(201).json(await agent.sessions.create({
+      ...(text(body.id) ? { id: text(body.id) } : {}),
+      ...(bodyUserId ? { userId: bodyUserId } : {}),
+      ...(body.title !== undefined ? { title: text(body.title) ?? '' } : {}),
+      ...(isRecord(body.metadata) ? { metadata: body.metadata } : {}),
+    }));
+  }));
+
+  // 以下接口只负责会话和消息生命周期，不承担用户归属校验。
+  router.get('/:sessionId', asyncRoute(async (request, response) => {
+    response.json(await getSessionOrThrow(agent, request.params.sessionId));
+  }));
+
+  router.post('/:sessionId/archive', asyncRoute(async (request, response) => {
+    await getSessionOrThrow(agent, request.params.sessionId);
+    response.json(await agent.sessions.archive(request.params.sessionId));
+  }));
+
+  router.post('/:sessionId/restore', asyncRoute(async (request, response) => {
+    await getSessionOrThrow(agent, request.params.sessionId);
+    response.json(await agent.sessions.restore(request.params.sessionId));
+  }));
+
+  router.get('/:sessionId/messages', asyncRoute(async (request, response) => {
+    await getSessionOrThrow(agent, request.params.sessionId);
+    response.json(await agent.messages.list(request.params.sessionId, pagination(request)));
+  }));
+
+  router.post('/:sessionId/messages', asyncRoute(async (request, response) => {
+    const sessionId = request.params.sessionId;
+    await getSessionOrThrow(agent, sessionId);
+    const body = requestBody(request);
+    const input = messageInput(body as Record<string, unknown>);
+    response.json(await agent.invoke(input, buildAgentRequest(request, body, resolveSessionId(sessionId, text(body.sessionId)))));
+  }));
+
+  router.post('/:sessionId/stream', asyncRoute(async (request, response) => {
+    const sessionId = request.params.sessionId;
+    await getSessionOrThrow(agent, sessionId);
+    const body = requestBody(request);
+    const input = messageInput(body as Record<string, unknown>);
+    beginSse(response);
+    await pipeSse(response, agent.stream(input, buildAgentRequest(request, body, resolveSessionId(sessionId, text(body.sessionId)))));
+  }));
+
+  return router;
+}

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

@@ -1,60 +1,60 @@
-import { readFileSync } from 'node:fs';
-import type { Agent } from '@gt-fe/eap-sdk';
-import { badRequest, notFound } from '../errors.js';
-import { isRecord, text } from '../shared/request.js';
-
-export function buildCapabilities(agent: Agent): Record<string, unknown> {
-  // 能力描述从物化后的 manifest/graph 读取，避免前端重复维护 Agent 配置。
-  const manifest = readJsonFile(agent.target.manifestPath);
-  const graph = readJsonFile(agent.target.graphPath);
-  const manifestRecord = isRecord(manifest) ? manifest : {};
-  const graphRecord = isRecord(graph) ? graph : {};
-  const nodes = Array.isArray(graphRecord.nodes)
-    ? graphRecord.nodes.filter(isRecord).map((node) => ({ id: node.id, type: node.type }))
-    : [];
-  const agentCode = encodeURIComponent(agent.target.agentCode);
-  return {
-    agent: {
-      code: agent.target.agentCode,
-      version: agent.target.version,
-      name: text(manifestRecord.name) ?? agent.target.agentCode,
-      description: text(manifestRecord.description) ?? '',
-      models: manifestRecord.models ?? {},
-      tools: Array.isArray(manifestRecord.toolRefs) ? manifestRecord.toolRefs : [],
-      skills: Array.isArray(manifestRecord.skillRefs) ? manifestRecord.skillRefs : [],
-    },
-    capabilities: {
-      invoke: true,
-      stream: true,
-      sessions: { create: true, list: true, get: true, archive: true, restore: false },
-      messages: { list: true, send: true },
-    },
-    endpoints: {
-      invoke: `/api/v1/agents/${agentCode}/invoke`,
-      stream: `/api/v1/agents/${agentCode}/stream`,
-      sessions: `/api/v1/agents/${agentCode}/sessions`,
-      messages: `/api/v1/agents/${agentCode}/sessions/{sessionId}/messages`,
-    },
-    graph: { nodes },
-  };
-}
-
-export async function getSessionOrThrow(agent: Agent, sessionId: string) {
-  const session = await agent.sessions.get(sessionId);
-  if (!session) throw notFound('Session not found');
-  return session;
-}
-
-export function messageInput(body: Record<string, unknown>): string {
-  const input = text(body.input) ?? text(body.content);
-  if (!input) throw badRequest('Request body requires a non-empty input or content string');
-  return input;
-}
-
-function readJsonFile(path: string): unknown {
-  try {
-    return JSON.parse(readFileSync(path, 'utf8'));
-  } catch {
-    return {};
-  }
-}
+import { readFileSync } from 'node:fs';
+import type { Agent } from '@gt-fe/eap-sdk';
+import { badRequest, notFound } from '../errors.js';
+import { isRecord, text } from '../shared/request.js';
+
+export function buildCapabilities(agent: Agent): Record<string, unknown> {
+  // 能力描述从物化后的 manifest/graph 读取，避免前端重复维护 Agent 配置。
+  const manifest = readJsonFile(agent.target.manifestPath);
+  const graph = readJsonFile(agent.target.graphPath);
+  const manifestRecord = isRecord(manifest) ? manifest : {};
+  const graphRecord = isRecord(graph) ? graph : {};
+  const nodes = Array.isArray(graphRecord.nodes)
+    ? graphRecord.nodes.filter(isRecord).map((node) => ({ id: node.id, type: node.type }))
+    : [];
+  const agentCode = encodeURIComponent(agent.target.agentCode);
+  return {
+    agent: {
+      code: agent.target.agentCode,
+      version: agent.target.version,
+      name: text(manifestRecord.name) ?? agent.target.agentCode,
+      description: text(manifestRecord.description) ?? '',
+      models: manifestRecord.models ?? {},
+      tools: Array.isArray(manifestRecord.toolRefs) ? manifestRecord.toolRefs : [],
+      skills: Array.isArray(manifestRecord.skillRefs) ? manifestRecord.skillRefs : [],
+    },
+    capabilities: {
+      invoke: true,
+      stream: true,
+      sessions: { create: true, list: true, get: true, archive: true, restore: false },
+      messages: { list: true, send: true },
+    },
+    endpoints: {
+      invoke: `/api/v1/agents/${agentCode}/invoke`,
+      stream: `/api/v1/agents/${agentCode}/stream`,
+      sessions: `/api/v1/agents/${agentCode}/sessions`,
+      messages: `/api/v1/agents/${agentCode}/sessions/{sessionId}/messages`,
+    },
+    graph: { nodes },
+  };
+}
+
+export async function getSessionOrThrow(agent: Agent, sessionId: string) {
+  const session = await agent.sessions.get(sessionId);
+  if (!session) throw notFound('Session not found');
+  return session;
+}
+
+export function messageInput(body: Record<string, unknown>): string {
+  const input = text(body.input) ?? text(body.content);
+  if (!input) throw badRequest('Request body requires a non-empty input or content string');
+  return input;
+}
+
+function readJsonFile(path: string): unknown {
+  try {
+    return JSON.parse(readFileSync(path, 'utf8'));
+  } catch {
+    return {};
+  }
+}

package/dist/templates/agent-api-orchestration/src/http/services/resource-service.ts

@@ -1,95 +1,95 @@
-import type {
-  Agent,
-  AgentResourceManager,
-  ResourceCatalogItem,
-  AgentResourceState,
-  ResourceActivationOptions,
-  InstallResourceRequest,
-  RefreshResourceRequest,
-  ReloadResult,
-  ResourceApplyOptions,
-  ResourceChangeResult,
-  ResourceMutationOptions,
-  ResourceQuery,
-  ResourceRef,
-} from '@gt-fe/eap-sdk';
-
-export interface ResourceApplyAndReloadResult {
-  change: ResourceChangeResult;
-  reload?: ReloadResult;
-}
-
-/**
- * Host-facing resource workflow. The SDK supplies the interface; the host
- * supplies the manager and decides when an effective Runtime may be replaced.
- */
-export class AgentResourceService {
-  constructor(private readonly agent: Agent) {}
-
-  get manager(): AgentResourceManager {
-    return this.agent.resources;
-  }
-
-  listMarket(query?: ResourceQuery): Promise<ResourceCatalogItem[]> {
-    return this.manager.listMarket(query);
-  }
-
-  listInstalled(query?: ResourceQuery): Promise<AgentResourceState[]> {
-    return this.manager.listInstalled(query);
-  }
-
-  get(ref: ResourceRef): Promise<AgentResourceState | null> {
-    return this.manager.get(ref);
-  }
-
-  install(request: InstallResourceRequest): Promise<ResourceChangeResult> {
-    return this.manager.install(request);
-  }
-
-  update(request?: RefreshResourceRequest): Promise<ResourceChangeResult[]> {
-    return this.manager.refresh(request);
-  }
-
-  uninstall(ref: ResourceRef, options?: ResourceMutationOptions): Promise<ResourceChangeResult> {
-    return this.manager.uninstall(ref, options);
-  }
-
-  enable(ref: ResourceRef, options?: ResourceActivationOptions): Promise<ResourceChangeResult> {
-    return this.manager.enable(ref, options);
-  }
-
-  disable(ref: ResourceRef, options?: ResourceActivationOptions): Promise<ResourceChangeResult> {
-    return this.manager.disable(ref, options);
-  }
-
-  apply(options?: ResourceApplyOptions): Promise<ResourceChangeResult> {
-    return this.manager.apply(options);
-  }
-
-  reload(): Promise<ReloadResult> {
-    return this.agent.reload();
-  }
-
-  invalidate(ref?: ResourceRef): Promise<void> {
-    return this.manager.invalidate(ref);
-  }
-
-  /**
-   * Materializes the desired resource set without an implicit reload, then
-   * explicitly switches the Agent when the manager reports that it is needed.
-   */
-  async applyAndReload(resources?: ResourceRef[]): Promise<ResourceApplyAndReloadResult> {
-    const change = await this.manager.apply({
-      ...(resources ? { resources } : {}),
-      reload: false,
-    });
-    if (change.status === 'failed' || !change.requiresReload) return { change };
-
-    const reload = await this.agent.reload();
-    return { change, reload };
-  }
-}
-
-export function createAgentResourceService(agent: Agent): AgentResourceService {
-  return new AgentResourceService(agent);
-}
+import type {
+  Agent,
+  AgentResourceManager,
+  ResourceCatalogItem,
+  AgentResourceState,
+  ResourceActivationOptions,
+  InstallResourceRequest,
+  RefreshResourceRequest,
+  ReloadResult,
+  ResourceApplyOptions,
+  ResourceChangeResult,
+  ResourceMutationOptions,
+  ResourceQuery,
+  ResourceRef,
+} from '@gt-fe/eap-sdk';
+
+export interface ResourceApplyAndReloadResult {
+  change: ResourceChangeResult;
+  reload?: ReloadResult;
+}
+
+/**
+ * Host-facing resource workflow. The SDK supplies the interface; the host
+ * supplies the manager and decides when an effective Runtime may be replaced.
+ */
+export class AgentResourceService {
+  constructor(private readonly agent: Agent) {}
+
+  get manager(): AgentResourceManager {
+    return this.agent.resources;
+  }
+
+  listMarket(query?: ResourceQuery): Promise<ResourceCatalogItem[]> {
+    return this.manager.listMarket(query);
+  }
+
+  listInstalled(query?: ResourceQuery): Promise<AgentResourceState[]> {
+    return this.manager.listInstalled(query);
+  }
+
+  get(ref: ResourceRef): Promise<AgentResourceState | null> {
+    return this.manager.get(ref);
+  }
+
+  install(request: InstallResourceRequest): Promise<ResourceChangeResult> {
+    return this.manager.install(request);
+  }
+
+  update(request?: RefreshResourceRequest): Promise<ResourceChangeResult[]> {
+    return this.manager.refresh(request);
+  }
+
+  uninstall(ref: ResourceRef, options?: ResourceMutationOptions): Promise<ResourceChangeResult> {
+    return this.manager.uninstall(ref, options);
+  }
+
+  enable(ref: ResourceRef, options?: ResourceActivationOptions): Promise<ResourceChangeResult> {
+    return this.manager.enable(ref, options);
+  }
+
+  disable(ref: ResourceRef, options?: ResourceActivationOptions): Promise<ResourceChangeResult> {
+    return this.manager.disable(ref, options);
+  }
+
+  apply(options?: ResourceApplyOptions): Promise<ResourceChangeResult> {
+    return this.manager.apply(options);
+  }
+
+  reload(): Promise<ReloadResult> {
+    return this.agent.reload();
+  }
+
+  invalidate(ref?: ResourceRef): Promise<void> {
+    return this.manager.invalidate(ref);
+  }
+
+  /**
+   * Materializes the desired resource set without an implicit reload, then
+   * explicitly switches the Agent when the manager reports that it is needed.
+   */
+  async applyAndReload(resources?: ResourceRef[]): Promise<ResourceApplyAndReloadResult> {
+    const change = await this.manager.apply({
+      ...(resources ? { resources } : {}),
+      reload: false,
+    });
+    if (change.status === 'failed' || !change.requiresReload) return { change };
+
+    const reload = await this.agent.reload();
+    return { change, reload };
+  }
+}
+
+export function createAgentResourceService(agent: Agent): AgentResourceService {
+  return new AgentResourceService(agent);
+}