@eggjs/controller-decorator 4.0.2-beta.1 → 4.0.2-beta.10

package/dist/decorator/agent/AgentController.d.ts

@@ -0,0 +1,6 @@
+import { EggProtoImplClass } from "@eggjs/tegg-types";
+
+//#region src/decorator/agent/AgentController.d.ts
+declare function AgentController(): (constructor: EggProtoImplClass) => void;
+//#endregion
+export { AgentController };

package/dist/decorator/agent/AgentController.js

@@ -0,0 +1,141 @@
+import { ControllerInfoUtil } from "../../util/ControllerInfoUtil.js";
+import { MethodInfoUtil } from "../../util/MethodInfoUtil.js";
+import { AgentInfoUtil } from "../../util/AgentInfoUtil.js";
+import { HTTPInfoUtil } from "../../util/HTTPInfoUtil.js";
+import { PrototypeUtil, SingletonProto } from "@eggjs/core-decorator";
+import { AGENT_CONTROLLER_PROTO_IMPL_TYPE, AccessLevel, ControllerType, HTTPMethodEnum, HTTPParamType } from "@eggjs/tegg-types";
+import { StackUtil } from "@eggjs/tegg-common-util";
+
+//#region src/decorator/agent/AgentController.ts
+function createNotImplemented(methodName, paramCount) {
+	let fn;
+	if (paramCount >= 2) fn = async function(_a, _b) {
+		throw new Error(`${methodName} not implemented`);
+	};
+	else if (paramCount === 1) fn = async function(_arg) {
+		throw new Error(`${methodName} not implemented`);
+	};
+	else fn = async function() {
+		throw new Error(`${methodName} not implemented`);
+	};
+	AgentInfoUtil.setNotImplemented(fn);
+	return fn;
+}
+const AGENT_ROUTES = [
+	{
+		methodName: "createThread",
+		httpMethod: HTTPMethodEnum.POST,
+		path: "/threads",
+		params: []
+	},
+	{
+		methodName: "getThread",
+		httpMethod: HTTPMethodEnum.GET,
+		path: "/threads/:id",
+		params: [{
+			index: 0,
+			type: "pathParam",
+			name: "id"
+		}]
+	},
+	{
+		methodName: "getLatestRunId",
+		httpMethod: HTTPMethodEnum.GET,
+		path: "/threads/:id/latest-run",
+		params: [{
+			index: 0,
+			type: "pathParam",
+			name: "id"
+		}]
+	},
+	{
+		methodName: "asyncRun",
+		httpMethod: HTTPMethodEnum.POST,
+		path: "/runs",
+		params: [{
+			index: 0,
+			type: "body"
+		}]
+	},
+	{
+		methodName: "streamRun",
+		httpMethod: HTTPMethodEnum.POST,
+		path: "/runs/stream",
+		params: [{
+			index: 0,
+			type: "body"
+		}]
+	},
+	{
+		methodName: "getRunStream",
+		httpMethod: HTTPMethodEnum.GET,
+		path: "/runs/:id/stream",
+		params: [{
+			index: 0,
+			type: "pathParam",
+			name: "id"
+		}, {
+			index: 1,
+			type: "query",
+			name: "lastSeq"
+		}]
+	},
+	{
+		methodName: "syncRun",
+		httpMethod: HTTPMethodEnum.POST,
+		path: "/runs/wait",
+		params: [{
+			index: 0,
+			type: "body"
+		}]
+	},
+	{
+		methodName: "getRun",
+		httpMethod: HTTPMethodEnum.GET,
+		path: "/runs/:id",
+		params: [{
+			index: 0,
+			type: "pathParam",
+			name: "id"
+		}]
+	},
+	{
+		methodName: "cancelRun",
+		httpMethod: HTTPMethodEnum.POST,
+		path: "/runs/:id/cancel",
+		params: [{
+			index: 0,
+			type: "pathParam",
+			name: "id"
+		}]
+	}
+];
+function AgentController() {
+	return function(constructor) {
+		ControllerInfoUtil.setControllerType(constructor, ControllerType.HTTP);
+		HTTPInfoUtil.setHTTPPath("/api/v1", constructor);
+		SingletonProto({
+			accessLevel: AccessLevel.PUBLIC,
+			protoImplType: AGENT_CONTROLLER_PROTO_IMPL_TYPE
+		})(constructor);
+		PrototypeUtil.setFilePath(constructor, StackUtil.getCalleeFromStack(false, 5));
+		for (const route of AGENT_ROUTES) {
+			if (!constructor.prototype[route.methodName]) constructor.prototype[route.methodName] = createNotImplemented(route.methodName, route.params.length);
+			MethodInfoUtil.setMethodControllerType(constructor, route.methodName, ControllerType.HTTP);
+			HTTPInfoUtil.setHTTPMethodMethod(route.httpMethod, constructor, route.methodName);
+			HTTPInfoUtil.setHTTPMethodPath(route.path, constructor, route.methodName);
+			for (const param of route.params) if (param.type === "body") HTTPInfoUtil.setHTTPMethodParamType(HTTPParamType.BODY, param.index, constructor, route.methodName);
+			else if (param.type === "pathParam") {
+				HTTPInfoUtil.setHTTPMethodParamType(HTTPParamType.PARAM, param.index, constructor, route.methodName);
+				HTTPInfoUtil.setHTTPMethodParamName(param.name, param.index, constructor, route.methodName);
+			} else if (param.type === "query") {
+				HTTPInfoUtil.setHTTPMethodParamType(HTTPParamType.QUERY, param.index, constructor, route.methodName);
+				HTTPInfoUtil.setHTTPMethodParamName(param.name, param.index, constructor, route.methodName);
+			}
+		}
+		AgentInfoUtil.setAgentController(constructor);
+	};
+}
+
+//#endregion
+export { AgentController };

package/dist/decorator/agent/AgentHandler.d.ts

@@ -0,0 +1,33 @@
+import { AgentMessage, CreateRunInput, RunObject, ThreadObject, ThreadObjectWithMessages } from "@eggjs/tegg-types/agent-runtime";
+
+//#region src/decorator/agent/AgentHandler.d.ts
+interface AgentHandler {
+  execRun(input: CreateRunInput, signal?: AbortSignal): AsyncGenerator<AgentMessage>;
+  /** Create the AgentStore used to persist threads and runs. */
+  createStore(): Promise<unknown>;
+  /**
+  * Optional hook to decide whether the executor's underlying session has
+  * been committed to persistent storage (for example the Claude Code SDK
+  * jsonl file on disk). The runtime calls this each time a new message is
+  * yielded from `execRun`; once it returns true, `cancelRun` is allowed to
+  * abort and persist the thread.
+  *
+  * When not implemented, the runtime uses a default heuristic: any message
+  * with `type !== 'system'` counts as committed (covers the Claude Code SDK
+  * case where `system/init` is emitted before the session is fully written).
+  */
+  isSessionCommitted?(msg: AgentMessage, history: AgentMessage[]): boolean | Promise<boolean>;
+  createThread?(): Promise<ThreadObject>;
+  getThread?(threadId: string): Promise<ThreadObjectWithMessages>;
+  getLatestRunId?(threadId: string): Promise<{
+    threadId: string;
+    runId: string | null;
+  }>;
+  asyncRun?(input: CreateRunInput): Promise<RunObject>;
+  streamRun?(input: CreateRunInput): Promise<void>;
+  syncRun?(input: CreateRunInput): Promise<RunObject>;
+  getRun?(runId: string): Promise<RunObject>;
+  cancelRun?(runId: string): Promise<RunObject>;
+}
+//#endregion
+export { AgentHandler };

package/dist/decorator/agent/index.d.ts

@@ -0,0 +1,2 @@
+import { AgentController } from "./AgentController.js";
+import { AgentHandler } from "./AgentHandler.js";

package/dist/decorator/agent/index.js

@@ -0,0 +1,3 @@
+import { AgentController } from "./AgentController.js";
+
+export {  };

package/dist/decorator/index.d.ts

@@ -10,5 +10,8 @@ import { MCPPrompt, PromptArgsSchema } from "./mcp/MCPPrompt.js";
 import { MCPResource } from "./mcp/MCPResource.js";
 import { MCPTool, ToolArgsSchema } from "./mcp/MCPTool.js";
 import "./mcp/index.js";
+import { AgentController } from "./agent/AgentController.js";
+import { AgentHandler } from "./agent/AgentHandler.js";
+import "./agent/index.js";
 import { Acl } from "./Acl.js";
 import { Middleware } from "./Middleware.js";

package/dist/decorator/index.js

@@ -10,6 +10,8 @@ import { MCPPrompt, PromptArgsSchema } from "./mcp/MCPPrompt.js";
 import { MCPResource } from "./mcp/MCPResource.js";
 import { MCPTool, ToolArgsSchema } from "./mcp/MCPTool.js";
 import "./mcp/index.js";
+import { AgentController } from "./agent/AgentController.js";
+import "./agent/index.js";
 import { Acl } from "./Acl.js";
 import { Middleware } from "./Middleware.js";
 

package/dist/index.d.ts

@@ -10,6 +10,8 @@ import { MCPController } from "./decorator/mcp/MCPController.js";
 import { MCPPrompt, PromptArgsSchema } from "./decorator/mcp/MCPPrompt.js";
 import { MCPResource } from "./decorator/mcp/MCPResource.js";
 import { MCPTool, ToolArgsSchema } from "./decorator/mcp/MCPTool.js";
+import { AgentController } from "./decorator/agent/AgentController.js";
+import { AgentHandler } from "./decorator/agent/AgentHandler.js";
 import { Acl } from "./decorator/Acl.js";
 import { Middleware } from "./decorator/Middleware.js";
 import "./decorator/index.js";
@@ -32,6 +34,7 @@ import { MCPControllerToolMetaBuilder } from "./impl/mcp/MCPControllerToolMetaBu
 import "./impl/index.js";
 import { ControllerValidator } from "./util/validator/ControllerValidator.js";
 import { MethodValidator } from "./util/validator/MethodValidator.js";
+import { AgentInfoUtil } from "./util/AgentInfoUtil.js";
 import { ControllerInfoUtil } from "./util/ControllerInfoUtil.js";
 import { ControllerMetadataUtil } from "./util/ControllerMetadataUtil.js";
 import { HTTPInfoUtil } from "./util/HTTPInfoUtil.js";
@@ -39,4 +42,4 @@ import { HTTPPriorityUtil } from "./util/HTTPPriorityUtil.js";
 import { MethodInfoUtil } from "./util/MethodInfoUtil.js";
 import "./util/index.js";
 export * from "@eggjs/tegg-types/controller-decorator";
-export { Acl, BodyParamMeta, ControllerInfoUtil, ControllerMetaBuilderFactory, ControllerMetadataUtil, ControllerValidator, Cookies, CookiesParamMeta, Extra, HTTPBody, InjectContext as HTTPContext, HTTPController, HTTPControllerMeta, HTTPControllerMetaBuilder, HTTPControllerMethodMetaBuilder, HTTPCookies, HTTPHeaders, HTTPInfoUtil, HTTPMethod, HTTPMethodMeta, HTTPParam, HTTPPriorityUtil, HTTPQueries, HTTPQuery, HTTPRequest, HTTPResponse, HeadersParamMeta, Host, InjectContext, MCPController, MCPControllerMeta, MCPControllerMetaBuilder, MCPControllerPromptMetaBuilder, MCPControllerResourceMetaBuilder, MCPControllerToolMetaBuilder, MCPInfoUtil, MCPPrompt, MCPPromptMeta, MCPResource, MCPResourceMeta, MCPTool, MCPToolMeta, MethodInfoUtil, MethodValidator, Middleware, ParamMeta, ParamMetaUtil, PathParamMeta, PromptArgsSchema, PromptArgsSchemaDetail, QueriesParamMeta, QueryParamMeta, RequestParamMeta, ToolArgsSchema, ToolArgsSchemaDetail };
+export { Acl, AgentController, AgentHandler, AgentInfoUtil, BodyParamMeta, ControllerInfoUtil, ControllerMetaBuilderFactory, ControllerMetadataUtil, ControllerValidator, Cookies, CookiesParamMeta, Extra, HTTPBody, InjectContext as HTTPContext, HTTPController, HTTPControllerMeta, HTTPControllerMetaBuilder, HTTPControllerMethodMetaBuilder, HTTPCookies, HTTPHeaders, HTTPInfoUtil, HTTPMethod, HTTPMethodMeta, HTTPParam, HTTPPriorityUtil, HTTPQueries, HTTPQuery, HTTPRequest, HTTPResponse, HeadersParamMeta, Host, InjectContext, MCPController, MCPControllerMeta, MCPControllerMetaBuilder, MCPControllerPromptMetaBuilder, MCPControllerResourceMetaBuilder, MCPControllerToolMetaBuilder, MCPInfoUtil, MCPPrompt, MCPPromptMeta, MCPResource, MCPResourceMeta, MCPTool, MCPToolMeta, MethodInfoUtil, MethodValidator, Middleware, ParamMeta, ParamMetaUtil, PathParamMeta, PromptArgsSchema, PromptArgsSchemaDetail, QueriesParamMeta, QueryParamMeta, RequestParamMeta, ToolArgsSchema, ToolArgsSchemaDetail };

package/dist/index.js

@@ -2,6 +2,7 @@ import { ControllerInfoUtil } from "./util/ControllerInfoUtil.js";
 import { ControllerValidator } from "./util/validator/ControllerValidator.js";
 import { MethodInfoUtil } from "./util/MethodInfoUtil.js";
 import { MethodValidator } from "./util/validator/MethodValidator.js";
+import { AgentInfoUtil } from "./util/AgentInfoUtil.js";
 import { ControllerMetadataUtil } from "./util/ControllerMetadataUtil.js";
 import { HTTPInfoUtil } from "./util/HTTPInfoUtil.js";
 import { HTTPPriorityUtil } from "./util/HTTPPriorityUtil.js";
@@ -19,6 +20,7 @@ import { MCPController } from "./decorator/mcp/MCPController.js";
 import { MCPPrompt, PromptArgsSchema } from "./decorator/mcp/MCPPrompt.js";
 import { MCPResource } from "./decorator/mcp/MCPResource.js";
 import { MCPTool, ToolArgsSchema } from "./decorator/mcp/MCPTool.js";
+import { AgentController } from "./decorator/agent/AgentController.js";
 import { Acl } from "./decorator/Acl.js";
 import { Middleware } from "./decorator/Middleware.js";
 import "./decorator/index.js";
@@ -41,4 +43,4 @@ import "./impl/index.js";
 
 export * from "@eggjs/tegg-types/controller-decorator"
 
-export { Acl, BodyParamMeta, ControllerInfoUtil, ControllerMetaBuilderFactory, ControllerMetadataUtil, ControllerValidator, Cookies, CookiesParamMeta, Extra, HTTPBody, InjectContext as HTTPContext, HTTPController, HTTPControllerMeta, HTTPControllerMetaBuilder, HTTPControllerMethodMetaBuilder, HTTPCookies, HTTPHeaders, HTTPInfoUtil, HTTPMethod, HTTPMethodMeta, HTTPParam, HTTPPriorityUtil, HTTPQueries, HTTPQuery, HTTPRequest, HTTPResponse, HeadersParamMeta, Host, InjectContext, MCPController, MCPControllerMeta, MCPControllerMetaBuilder, MCPControllerPromptMetaBuilder, MCPControllerResourceMetaBuilder, MCPControllerToolMetaBuilder, MCPInfoUtil, MCPPrompt, MCPPromptMeta, MCPResource, MCPResourceMeta, MCPTool, MCPToolMeta, MethodInfoUtil, MethodValidator, Middleware, ParamMeta, ParamMetaUtil, PathParamMeta, PromptArgsSchema, QueriesParamMeta, QueryParamMeta, RequestParamMeta, ToolArgsSchema };
+export { Acl, AgentController, AgentInfoUtil, BodyParamMeta, ControllerInfoUtil, ControllerMetaBuilderFactory, ControllerMetadataUtil, ControllerValidator, Cookies, CookiesParamMeta, Extra, HTTPBody, InjectContext as HTTPContext, HTTPController, HTTPControllerMeta, HTTPControllerMetaBuilder, HTTPControllerMethodMetaBuilder, HTTPCookies, HTTPHeaders, HTTPInfoUtil, HTTPMethod, HTTPMethodMeta, HTTPParam, HTTPPriorityUtil, HTTPQueries, HTTPQuery, HTTPRequest, HTTPResponse, HeadersParamMeta, Host, InjectContext, MCPController, MCPControllerMeta, MCPControllerMetaBuilder, MCPControllerPromptMetaBuilder, MCPControllerResourceMetaBuilder, MCPControllerToolMetaBuilder, MCPInfoUtil, MCPPrompt, MCPPromptMeta, MCPResource, MCPResourceMeta, MCPTool, MCPToolMeta, MethodInfoUtil, MethodValidator, Middleware, ParamMeta, ParamMetaUtil, PathParamMeta, PromptArgsSchema, QueriesParamMeta, QueryParamMeta, RequestParamMeta, ToolArgsSchema };

package/dist/util/AgentInfoUtil.d.ts

@@ -0,0 +1,13 @@
+import { EggProtoImplClass } from "@eggjs/tegg-types";
+
+//#region src/util/AgentInfoUtil.d.ts
+declare class AgentInfoUtil {
+  static setAgentController(clazz: EggProtoImplClass): void;
+  static isAgentController(clazz: EggProtoImplClass): boolean;
+  static setNotImplemented(fn: Function): void;
+  static isNotImplemented(fn: Function): boolean;
+  static setEnhanced(clazz: EggProtoImplClass): void;
+  static isEnhanced(clazz: EggProtoImplClass): boolean;
+}
+//#endregion
+export { AgentInfoUtil };

package/dist/util/AgentInfoUtil.js

@@ -0,0 +1,27 @@
+import { MetadataUtil } from "@eggjs/core-decorator";
+import { CONTROLLER_AGENT_CONTROLLER, CONTROLLER_AGENT_ENHANCED, CONTROLLER_AGENT_NOT_IMPLEMENTED } from "@eggjs/tegg-types";
+
+//#region src/util/AgentInfoUtil.ts
+var AgentInfoUtil = class {
+	static setAgentController(clazz) {
+		MetadataUtil.defineMetaData(CONTROLLER_AGENT_CONTROLLER, true, clazz);
+	}
+	static isAgentController(clazz) {
+		return MetadataUtil.getBooleanMetaData(CONTROLLER_AGENT_CONTROLLER, clazz);
+	}
+	static setNotImplemented(fn) {
+		Reflect.defineMetadata(CONTROLLER_AGENT_NOT_IMPLEMENTED, true, fn);
+	}
+	static isNotImplemented(fn) {
+		return !!Reflect.getMetadata(CONTROLLER_AGENT_NOT_IMPLEMENTED, fn);
+	}
+	static setEnhanced(clazz) {
+		MetadataUtil.defineMetaData(CONTROLLER_AGENT_ENHANCED, true, clazz);
+	}
+	static isEnhanced(clazz) {
+		return MetadataUtil.getBooleanMetaData(CONTROLLER_AGENT_ENHANCED, clazz);
+	}
+};
+
+//#endregion
+export { AgentInfoUtil };

package/dist/util/index.d.ts

@@ -2,6 +2,7 @@ import { MCPInfoUtil, PromptArgsSchemaDetail, ToolArgsSchemaDetail } from "./MCP
 import { ControllerValidator } from "./validator/ControllerValidator.js";
 import { MethodValidator } from "./validator/MethodValidator.js";
 import "./validator/index.js";
+import { AgentInfoUtil } from "./AgentInfoUtil.js";
 import { ControllerInfoUtil } from "./ControllerInfoUtil.js";
 import { ControllerMetadataUtil } from "./ControllerMetadataUtil.js";
 import { HTTPInfoUtil } from "./HTTPInfoUtil.js";

package/dist/util/index.js

@@ -3,6 +3,7 @@ import { ControllerValidator } from "./validator/ControllerValidator.js";
 import { MethodInfoUtil } from "./MethodInfoUtil.js";
 import { MethodValidator } from "./validator/MethodValidator.js";
 import "./validator/index.js";
+import { AgentInfoUtil } from "./AgentInfoUtil.js";
 import { ControllerMetadataUtil } from "./ControllerMetadataUtil.js";
 import { HTTPInfoUtil } from "./HTTPInfoUtil.js";
 import { HTTPPriorityUtil } from "./HTTPPriorityUtil.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/controller-decorator",
-  "version": "4.0.2-beta.1",
+  "version": "4.0.2-beta.10",
   "description": "tegg controller decorator",
   "keywords": [
     "controller",
@@ -38,17 +38,17 @@
     "@modelcontextprotocol/sdk": "^1.23.0",
     "is-type-of": "^2.2.0",
     "path-to-regexp": "^1.9.0",
-    "@eggjs/aop-decorator": "4.0.2-beta.1",
-    "@eggjs/cookies": "4.0.2-beta.1",
-    "@eggjs/metadata": "4.0.2-beta.1",
-    "@eggjs/core-decorator": "4.0.2-beta.1",
-    "@eggjs/tegg-common-util": "4.0.2-beta.1",
-    "@eggjs/tegg-types": "4.0.2-beta.1"
+    "@eggjs/aop-decorator": "4.0.2-beta.10",
+    "@eggjs/core-decorator": "4.0.2-beta.10",
+    "@eggjs/metadata": "4.0.2-beta.10",
+    "@eggjs/tegg-common-util": "4.0.2-beta.10",
+    "@eggjs/cookies": "4.0.2-beta.10",
+    "@eggjs/tegg-types": "4.0.2-beta.10"
   },
   "devDependencies": {
     "@types/node": "^24.10.2",
     "typescript": "^5.9.3",
-    "egg": "4.1.2-beta.1"
+    "egg": "4.1.2-beta.10"
   },
   "engines": {
     "node": ">=22.18.0"