@eggjs/controller-decorator 3.72.0 → 3.73.0-beta.1

package/dist/index.d.ts

@@ -20,3 +20,5 @@ export * from './src/util/MCPInfoUtil';
 export * from './src/util/HTTPPriorityUtil';
 export { default as ControllerInfoUtil } from './src/util/ControllerInfoUtil';
 export { default as MethodInfoUtil } from './src/util/MethodInfoUtil';
+export * from './src/decorator/agent';
+export { AgentInfoUtil } from './src/util/AgentInfoUtil';

package/dist/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MethodInfoUtil = exports.ControllerInfoUtil = void 0;
+exports.AgentInfoUtil = exports.MethodInfoUtil = exports.ControllerInfoUtil = void 0;
 require("./src/impl/http/HTTPControllerMetaBuilder");
 require("./src/impl/mcp/MCPControllerMetaBuilder");
 __exportStar(require("@eggjs/tegg-types/controller-decorator"), exports);
@@ -42,4 +42,7 @@ var ControllerInfoUtil_1 = require("./src/util/ControllerInfoUtil");
 Object.defineProperty(exports, "ControllerInfoUtil", { enumerable: true, get: function () { return __importDefault(ControllerInfoUtil_1).default; } });
 var MethodInfoUtil_1 = require("./src/util/MethodInfoUtil");
 Object.defineProperty(exports, "MethodInfoUtil", { enumerable: true, get: function () { return __importDefault(MethodInfoUtil_1).default; } });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLHFEQUFtRDtBQUNuRCxtREFBaUQ7QUFFakQseUVBQXVEO0FBQ3ZELDhDQUE0QjtBQUM1QiwwREFBd0M7QUFDeEMsNkRBQTJDO0FBQzNDLHNEQUFvQztBQUNwQyxzRUFBb0Q7QUFDcEQsa0VBQWdEO0FBQ2hELGlFQUErQztBQUMvQyw0REFBMEM7QUFDMUMsb0VBQWtEO0FBQ2xELGdFQUE4QztBQUM5QyxrRUFBZ0Q7QUFDaEQsOERBQTRDO0FBQzVDLDREQUEwQztBQUMxQyw2RUFBMkQ7QUFDM0Qsb0VBQWtEO0FBQ2xELHlEQUF1QztBQUN2Qyw4REFBNEM7QUFFNUMsb0VBQThFO0FBQXJFLHlJQUFBLE9BQU8sT0FBc0I7QUFDdEMsNERBQXNFO0FBQTdELGlJQUFBLE9BQU8sT0FBa0IifQ==
+__exportStar(require("./src/decorator/agent"), exports);
+var AgentInfoUtil_1 = require("./src/util/AgentInfoUtil");
+Object.defineProperty(exports, "AgentInfoUtil", { enumerable: true, get: function () { return AgentInfoUtil_1.AgentInfoUtil; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLHFEQUFtRDtBQUNuRCxtREFBaUQ7QUFFakQseUVBQXVEO0FBQ3ZELDhDQUE0QjtBQUM1QiwwREFBd0M7QUFDeEMsNkRBQTJDO0FBQzNDLHNEQUFvQztBQUNwQyxzRUFBb0Q7QUFDcEQsa0VBQWdEO0FBQ2hELGlFQUErQztBQUMvQyw0REFBMEM7QUFDMUMsb0VBQWtEO0FBQ2xELGdFQUE4QztBQUM5QyxrRUFBZ0Q7QUFDaEQsOERBQTRDO0FBQzVDLDREQUEwQztBQUMxQyw2RUFBMkQ7QUFDM0Qsb0VBQWtEO0FBQ2xELHlEQUF1QztBQUN2Qyw4REFBNEM7QUFFNUMsb0VBQThFO0FBQXJFLHlJQUFBLE9BQU8sT0FBc0I7QUFDdEMsNERBQXNFO0FBQTdELGlJQUFBLE9BQU8sT0FBa0I7QUFFbEMsd0RBQXNDO0FBQ3RDLDBEQUF5RDtBQUFoRCw4R0FBQSxhQUFhLE9BQUEifQ==

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

@@ -0,0 +1,2 @@
+import type { EggProtoImplClass } from '@eggjs/tegg-types';
+export declare function AgentController(): (constructor: EggProtoImplClass) => void;

package/dist/src/decorator/agent/AgentController.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentController = AgentController;
+const core_decorator_1 = require("@eggjs/core-decorator");
+const tegg_common_util_1 = require("@eggjs/tegg-common-util");
+const tegg_types_1 = require("@eggjs/tegg-types");
+const AgentInfoUtil_1 = require("../../util/AgentInfoUtil");
+const ControllerInfoUtil_1 = __importDefault(require("../../util/ControllerInfoUtil"));
+const HTTPInfoUtil_1 = __importDefault(require("../../util/HTTPInfoUtil"));
+const MethodInfoUtil_1 = __importDefault(require("../../util/MethodInfoUtil"));
+// Default implementations for unimplemented methods.
+// Methods with hasParam=true need function.length === 1 for param validation.
+// Stubs are marked with Symbol.for('AGENT_NOT_IMPLEMENTED') so agent-runtime
+// can distinguish them from user-defined methods at enhancement time.
+function createNotImplemented(methodName, hasParam) {
+    let fn;
+    if (hasParam) {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        fn = async function (_arg) {
+            throw new Error(`${methodName} not implemented`);
+        };
+    }
+    else {
+        fn = async function () {
+            throw new Error(`${methodName} not implemented`);
+        };
+    }
+    AgentInfoUtil_1.AgentInfoUtil.setNotImplemented(fn);
+    return fn;
+}
+const AGENT_ROUTES = [
+    {
+        methodName: 'createThread',
+        httpMethod: tegg_types_1.HTTPMethodEnum.POST,
+        path: '/threads',
+        hasParam: false,
+    },
+    {
+        methodName: 'getThread',
+        httpMethod: tegg_types_1.HTTPMethodEnum.GET,
+        path: '/threads/:id',
+        paramType: 'pathParam',
+        paramName: 'id',
+        hasParam: true,
+    },
+    {
+        methodName: 'asyncRun',
+        httpMethod: tegg_types_1.HTTPMethodEnum.POST,
+        path: '/runs',
+        paramType: 'body',
+        hasParam: true,
+    },
+    {
+        methodName: 'streamRun',
+        httpMethod: tegg_types_1.HTTPMethodEnum.POST,
+        path: '/runs/stream',
+        paramType: 'body',
+        hasParam: true,
+    },
+    {
+        methodName: 'syncRun',
+        httpMethod: tegg_types_1.HTTPMethodEnum.POST,
+        path: '/runs/wait',
+        paramType: 'body',
+        hasParam: true,
+    },
+    {
+        methodName: 'getRun',
+        httpMethod: tegg_types_1.HTTPMethodEnum.GET,
+        path: '/runs/:id',
+        paramType: 'pathParam',
+        paramName: 'id',
+        hasParam: true,
+    },
+    {
+        methodName: 'cancelRun',
+        httpMethod: tegg_types_1.HTTPMethodEnum.POST,
+        path: '/runs/:id/cancel',
+        paramType: 'pathParam',
+        paramName: 'id',
+        hasParam: true,
+    },
+];
+function AgentController() {
+    return function (constructor) {
+        // Set controller type as HTTP so existing infrastructure handles it
+        ControllerInfoUtil_1.default.setControllerType(constructor, tegg_types_1.ControllerType.HTTP);
+        // Set the fixed base HTTP path
+        HTTPInfoUtil_1.default.setHTTPPath('/api/v1', constructor);
+        // Apply SingletonProto with custom proto impl type
+        const func = (0, core_decorator_1.SingletonProto)({
+            accessLevel: tegg_types_1.AccessLevel.PUBLIC,
+            protoImplType: tegg_types_1.AGENT_CONTROLLER_PROTO_IMPL_TYPE,
+        });
+        func(constructor);
+        // Set file path for prototype
+        // Stack depth 5: [0] getCalleeFromStack → [1] decorator fn → [2-4] reflect/oxc runtime → [5] user source
+        core_decorator_1.PrototypeUtil.setFilePath(constructor, tegg_common_util_1.StackUtil.getCalleeFromStack(false, 5));
+        // Register each agent route
+        for (const route of AGENT_ROUTES) {
+            // Inject default implementation if method not defined
+            if (!constructor.prototype[route.methodName]) {
+                constructor.prototype[route.methodName] = createNotImplemented(route.methodName, route.hasParam);
+            }
+            // Set method controller type
+            MethodInfoUtil_1.default.setMethodControllerType(constructor, route.methodName, tegg_types_1.ControllerType.HTTP);
+            // Set HTTP method (GET/POST)
+            HTTPInfoUtil_1.default.setHTTPMethodMethod(route.httpMethod, constructor, route.methodName);
+            // Set HTTP path
+            HTTPInfoUtil_1.default.setHTTPMethodPath(route.path, constructor, route.methodName);
+            // Set parameter metadata
+            if (route.paramType === 'body') {
+                HTTPInfoUtil_1.default.setHTTPMethodParamType(tegg_types_1.HTTPParamType.BODY, 0, constructor, route.methodName);
+            }
+            else if (route.paramType === 'pathParam') {
+                HTTPInfoUtil_1.default.setHTTPMethodParamType(tegg_types_1.HTTPParamType.PARAM, 0, constructor, route.methodName);
+                HTTPInfoUtil_1.default.setHTTPMethodParamName(route.paramName, 0, constructor, route.methodName);
+            }
+        }
+        // Mark the class as an AgentController for precise detection
+        AgentInfoUtil_1.AgentInfoUtil.setAgentController(constructor);
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQWdlbnRDb250cm9sbGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2RlY29yYXRvci9hZ2VudC9BZ2VudENvbnRyb2xsZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFtR0EsMENBK0NDO0FBbEpELDBEQUFzRTtBQUN0RSw4REFBb0Q7QUFFcEQsa0RBTTJCO0FBRTNCLDREQUF5RDtBQUN6RCx1RkFBK0Q7QUFDL0QsMkVBQW1EO0FBQ25ELCtFQUF1RDtBQVd2RCxxREFBcUQ7QUFDckQsOEVBQThFO0FBQzlFLDZFQUE2RTtBQUM3RSxzRUFBc0U7QUFDdEUsU0FBUyxvQkFBb0IsQ0FBQyxVQUFrQixFQUFFLFFBQWlCO0lBQ2pFLElBQUksRUFBRSxDQUFDO0lBQ1AsSUFBSSxRQUFRLEVBQUUsQ0FBQztRQUNiLDZEQUE2RDtRQUM3RCxFQUFFLEdBQUcsS0FBSyxXQUFVLElBQWE7WUFDL0IsTUFBTSxJQUFJLEtBQUssQ0FBQyxHQUFHLFVBQVUsa0JBQWtCLENBQUMsQ0FBQztRQUNuRCxDQUFDLENBQUM7SUFDSixDQUFDO1NBQU0sQ0FBQztRQUNOLEVBQUUsR0FBRyxLQUFLO1lBQ1IsTUFBTSxJQUFJLEtBQUssQ0FBQyxHQUFHLFVBQVUsa0JBQWtCLENBQUMsQ0FBQztRQUNuRCxDQUFDLENBQUM7SUFDSixDQUFDO0lBQ0QsNkJBQWEsQ0FBQyxpQkFBaUIsQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUNwQyxPQUFPLEVBQUUsQ0FBQztBQUNaLENBQUM7QUFFRCxNQUFNLFlBQVksR0FBMkI7SUFDM0M7UUFDRSxVQUFVLEVBQUUsY0FBYztRQUMxQixVQUFVLEVBQUUsMkJBQWMsQ0FBQyxJQUFJO1FBQy9CLElBQUksRUFBRSxVQUFVO1FBQ2hCLFFBQVEsRUFBRSxLQUFLO0tBQ2hCO0lBQ0Q7UUFDRSxVQUFVLEVBQUUsV0FBVztRQUN2QixVQUFVLEVBQUUsMkJBQWMsQ0FBQyxHQUFHO1FBQzlCLElBQUksRUFBRSxjQUFjO1FBQ3BCLFNBQVMsRUFBRSxXQUFXO1FBQ3RCLFNBQVMsRUFBRSxJQUFJO1FBQ2YsUUFBUSxFQUFFLElBQUk7S0FDZjtJQUNEO1FBQ0UsVUFBVSxFQUFFLFVBQVU7UUFDdEIsVUFBVSxFQUFFLDJCQUFjLENBQUMsSUFBSTtRQUMvQixJQUFJLEVBQUUsT0FBTztRQUNiLFNBQVMsRUFBRSxNQUFNO1FBQ2pCLFFBQVEsRUFBRSxJQUFJO0tBQ2Y7SUFDRDtRQUNFLFVBQVUsRUFBRSxXQUFXO1FBQ3ZCLFVBQVUsRUFBRSwyQkFBYyxDQUFDLElBQUk7UUFDL0IsSUFBSSxFQUFFLGNBQWM7UUFDcEIsU0FBUyxFQUFFLE1BQU07UUFDakIsUUFBUSxFQUFFLElBQUk7S0FDZjtJQUNEO1FBQ0UsVUFBVSxFQUFFLFNBQVM7UUFDckIsVUFBVSxFQUFFLDJCQUFjLENBQUMsSUFBSTtRQUMvQixJQUFJLEVBQUUsWUFBWTtRQUNsQixTQUFTLEVBQUUsTUFBTTtRQUNqQixRQUFRLEVBQUUsSUFBSTtLQUNmO0lBQ0Q7UUFDRSxVQUFVLEVBQUUsUUFBUTtRQUNwQixVQUFVLEVBQUUsMkJBQWMsQ0FBQyxHQUFHO1FBQzlCLElBQUksRUFBRSxXQUFXO1FBQ2pCLFNBQVMsRUFBRSxXQUFXO1FBQ3RCLFNBQVMsRUFBRSxJQUFJO1FBQ2YsUUFBUSxFQUFFLElBQUk7S0FDZjtJQUNEO1FBQ0UsVUFBVSxFQUFFLFdBQVc7UUFDdkIsVUFBVSxFQUFFLDJCQUFjLENBQUMsSUFBSTtRQUMvQixJQUFJLEVBQUUsa0JBQWtCO1FBQ3hCLFNBQVMsRUFBRSxXQUFXO1FBQ3RCLFNBQVMsRUFBRSxJQUFJO1FBQ2YsUUFBUSxFQUFFLElBQUk7S0FDZjtDQUNGLENBQUM7QUFFRixTQUFnQixlQUFlO0lBQzdCLE9BQU8sVUFBUyxXQUE4QjtRQUM1QyxvRUFBb0U7UUFDcEUsNEJBQWtCLENBQUMsaUJBQWlCLENBQUMsV0FBVyxFQUFFLDJCQUFjLENBQUMsSUFBSSxDQUFDLENBQUM7UUFFdkUsK0JBQStCO1FBQy9CLHNCQUFZLENBQUMsV0FBVyxDQUFDLFNBQVMsRUFBRSxXQUFXLENBQUMsQ0FBQztRQUVqRCxtREFBbUQ7UUFDbkQsTUFBTSxJQUFJLEdBQUcsSUFBQSwrQkFBYyxFQUFDO1lBQzFCLFdBQVcsRUFBRSx3QkFBVyxDQUFDLE1BQU07WUFDL0IsYUFBYSxFQUFFLDZDQUFnQztTQUNoRCxDQUFDLENBQUM7UUFDSCxJQUFJLENBQUMsV0FBVyxDQUFDLENBQUM7UUFFbEIsOEJBQThCO1FBQzlCLHlHQUF5RztRQUN6Ryw4QkFBYSxDQUFDLFdBQVcsQ0FBQyxXQUFXLEVBQUUsNEJBQVMsQ0FBQyxrQkFBa0IsQ0FBQyxLQUFLLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUUvRSw0QkFBNEI7UUFDNUIsS0FBSyxNQUFNLEtBQUssSUFBSSxZQUFZLEVBQUUsQ0FBQztZQUNqQyxzREFBc0Q7WUFDdEQsSUFBSSxDQUFDLFdBQVcsQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxFQUFFLENBQUM7Z0JBQzdDLFdBQVcsQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxHQUFHLG9CQUFvQixDQUFDLEtBQUssQ0FBQyxVQUFVLEVBQUUsS0FBSyxDQUFDLFFBQVEsQ0FBQyxDQUFDO1lBQ25HLENBQUM7WUFFRCw2QkFBNkI7WUFDN0Isd0JBQWMsQ0FBQyx1QkFBdUIsQ0FBQyxXQUFXLEVBQUUsS0FBSyxDQUFDLFVBQVUsRUFBRSwyQkFBYyxDQUFDLElBQUksQ0FBQyxDQUFDO1lBRTNGLDZCQUE2QjtZQUM3QixzQkFBWSxDQUFDLG1CQUFtQixDQUFDLEtBQUssQ0FBQyxVQUFVLEVBQUUsV0FBVyxFQUFFLEtBQUssQ0FBQyxVQUFVLENBQUMsQ0FBQztZQUVsRixnQkFBZ0I7WUFDaEIsc0JBQVksQ0FBQyxpQkFBaUIsQ0FBQyxLQUFLLENBQUMsSUFBSSxFQUFFLFdBQVcsRUFBRSxLQUFLLENBQUMsVUFBVSxDQUFDLENBQUM7WUFFMUUseUJBQXlCO1lBQ3pCLElBQUksS0FBSyxDQUFDLFNBQVMsS0FBSyxNQUFNLEVBQUUsQ0FBQztnQkFDL0Isc0JBQVksQ0FBQyxzQkFBc0IsQ0FBQywwQkFBYSxDQUFDLElBQUksRUFBRSxDQUFDLEVBQUUsV0FBVyxFQUFFLEtBQUssQ0FBQyxVQUFVLENBQUMsQ0FBQztZQUM1RixDQUFDO2lCQUFNLElBQUksS0FBSyxDQUFDLFNBQVMsS0FBSyxXQUFXLEVBQUUsQ0FBQztnQkFDM0Msc0JBQVksQ0FBQyxzQkFBc0IsQ0FBQywwQkFBYSxDQUFDLEtBQUssRUFBRSxDQUFDLEVBQUUsV0FBVyxFQUFFLEtBQUssQ0FBQyxVQUFVLENBQUMsQ0FBQztnQkFDM0Ysc0JBQVksQ0FBQyxzQkFBc0IsQ0FBQyxLQUFLLENBQUMsU0FBVSxFQUFFLENBQUMsRUFBRSxXQUFXLEVBQUUsS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDO1lBQzFGLENBQUM7UUFDSCxDQUFDO1FBRUQsNkRBQTZEO1FBQzdELDZCQUFhLENBQUMsa0JBQWtCLENBQUMsV0FBVyxDQUFDLENBQUM7SUFDaEQsQ0FBQyxDQUFDO0FBQ0osQ0FBQyJ9

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

@@ -0,0 +1,13 @@
+import type { ThreadObject, ThreadObjectWithMessages, CreateRunInput, RunObject, AgentStreamMessage } from '@eggjs/tegg-types/agent-runtime';
+export interface AgentHandler {
+    execRun(input: CreateRunInput, signal?: AbortSignal): AsyncGenerator<AgentStreamMessage>;
+    /** Create the AgentStore used to persist threads and runs. */
+    createStore(): Promise<unknown>;
+    createThread?(): Promise<ThreadObject>;
+    getThread?(threadId: string): Promise<ThreadObjectWithMessages>;
+    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>;
+}

package/dist/src/decorator/agent/AgentHandler.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQWdlbnRIYW5kbGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2RlY29yYXRvci9hZ2VudC9BZ2VudEhhbmRsZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

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

@@ -0,0 +1,2 @@
+export * from './AgentController';
+export * from './AgentHandler';

package/dist/src/decorator/agent/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AgentController"), exports);
+__exportStar(require("./AgentHandler"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvZGVjb3JhdG9yL2FnZW50L2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxvREFBa0M7QUFDbEMsaURBQStCIn0=

package/dist/src/model/AgentControllerTypes.d.ts

@@ -0,0 +1,98 @@
+export interface InputMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string | InputContentPart[];
+    metadata?: Record<string, unknown>;
+}
+export interface InputContentPart {
+    type: 'text';
+    text: string;
+}
+export interface MessageObject {
+    id: string;
+    object: 'thread.message';
+    created_at: number;
+    thread_id?: string;
+    run_id?: string;
+    role: 'user' | 'assistant';
+    status: 'in_progress' | 'incomplete' | 'completed';
+    content: MessageContentBlock[];
+    metadata?: Record<string, unknown>;
+}
+export interface TextContentBlock {
+    type: 'text';
+    text: {
+        value: string;
+        annotations: unknown[];
+    };
+}
+export type MessageContentBlock = TextContentBlock;
+export interface ThreadObject {
+    id: string;
+    object: 'thread';
+    created_at: number;
+    metadata: Record<string, unknown>;
+}
+export interface ThreadObjectWithMessages extends ThreadObject {
+    messages: MessageObject[];
+}
+export type RunStatus = 'queued' | 'in_progress' | 'completed' | 'failed' | 'cancelled' | 'cancelling' | 'expired';
+export interface RunObject {
+    id: string;
+    object: 'thread.run';
+    created_at: number;
+    thread_id?: string;
+    status: RunStatus;
+    last_error?: {
+        code: string;
+        message: string;
+    } | null;
+    started_at?: number | null;
+    completed_at?: number | null;
+    cancelled_at?: number | null;
+    failed_at?: number | null;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    } | null;
+    metadata?: Record<string, unknown>;
+    output?: MessageObject[];
+    config?: AgentRunConfig;
+}
+export interface CreateRunInput {
+    thread_id?: string;
+    input: {
+        messages: InputMessage[];
+    };
+    config?: AgentRunConfig;
+    metadata?: Record<string, unknown>;
+}
+export interface MessageDeltaObject {
+    id: string;
+    object: 'thread.message.delta';
+    delta: {
+        content: MessageContentBlock[];
+    };
+}
+export interface AgentRunUsage {
+    total_tokens?: number;
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    duration_ms?: number;
+}
+export interface AgentRunConfig {
+    max_iterations?: number;
+    timeout_ms?: number;
+}
+export interface AgentStreamMessage {
+    type: string;
+    message?: {
+        role: string;
+        content: string | {
+            type: string;
+            text: string;
+        }[];
+    };
+    usage?: AgentRunUsage;
+    [key: string]: unknown;
+}

package/dist/src/model/AgentControllerTypes.js

@@ -0,0 +1,4 @@
+"use strict";
+// ===== Input Message (what clients send in request body) =====
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQWdlbnRDb250cm9sbGVyVHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbW9kZWwvQWdlbnRDb250cm9sbGVyVHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLGdFQUFnRSJ9

package/dist/src/util/AgentInfoUtil.d.ts

@@ -0,0 +1,9 @@
+import type { EggProtoImplClass } from '@eggjs/tegg-types';
+export 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;
+}

package/dist/src/util/AgentInfoUtil.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentInfoUtil = void 0;
+const core_decorator_1 = require("@eggjs/core-decorator");
+const tegg_types_1 = require("@eggjs/tegg-types");
+class AgentInfoUtil {
+    static setAgentController(clazz) {
+        core_decorator_1.MetadataUtil.defineMetaData(tegg_types_1.CONTROLLER_AGENT_CONTROLLER, true, clazz);
+    }
+    static isAgentController(clazz) {
+        return core_decorator_1.MetadataUtil.getBooleanMetaData(tegg_types_1.CONTROLLER_AGENT_CONTROLLER, clazz);
+    }
+    static setNotImplemented(fn) {
+        Reflect.defineMetadata(tegg_types_1.CONTROLLER_AGENT_NOT_IMPLEMENTED, true, fn);
+    }
+    static isNotImplemented(fn) {
+        return !!Reflect.getMetadata(tegg_types_1.CONTROLLER_AGENT_NOT_IMPLEMENTED, fn);
+    }
+    static setEnhanced(clazz) {
+        core_decorator_1.MetadataUtil.defineMetaData(tegg_types_1.CONTROLLER_AGENT_ENHANCED, true, clazz);
+    }
+    static isEnhanced(clazz) {
+        return core_decorator_1.MetadataUtil.getBooleanMetaData(tegg_types_1.CONTROLLER_AGENT_ENHANCED, clazz);
+    }
+}
+exports.AgentInfoUtil = AgentInfoUtil;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQWdlbnRJbmZvVXRpbC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy91dGlsL0FnZW50SW5mb1V0aWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsMERBQXFEO0FBQ3JELGtEQUkyQjtBQUczQixNQUFhLGFBQWE7SUFDeEIsTUFBTSxDQUFDLGtCQUFrQixDQUFDLEtBQXdCO1FBQ2hELDZCQUFZLENBQUMsY0FBYyxDQUFDLHdDQUEyQixFQUFFLElBQUksRUFBRSxLQUFLLENBQUMsQ0FBQztJQUN4RSxDQUFDO0lBRUQsTUFBTSxDQUFDLGlCQUFpQixDQUFDLEtBQXdCO1FBQy9DLE9BQU8sNkJBQVksQ0FBQyxrQkFBa0IsQ0FBQyx3Q0FBMkIsRUFBRSxLQUFLLENBQUMsQ0FBQztJQUM3RSxDQUFDO0lBRUQsTUFBTSxDQUFDLGlCQUFpQixDQUFDLEVBQVk7UUFDbkMsT0FBTyxDQUFDLGNBQWMsQ0FBQyw2Q0FBZ0MsRUFBRSxJQUFJLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDckUsQ0FBQztJQUVELE1BQU0sQ0FBQyxnQkFBZ0IsQ0FBQyxFQUFZO1FBQ2xDLE9BQU8sQ0FBQyxDQUFDLE9BQU8sQ0FBQyxXQUFXLENBQUMsNkNBQWdDLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDckUsQ0FBQztJQUVELE1BQU0sQ0FBQyxXQUFXLENBQUMsS0FBd0I7UUFDekMsNkJBQVksQ0FBQyxjQUFjLENBQUMsc0NBQXlCLEVBQUUsSUFBSSxFQUFFLEtBQUssQ0FBQyxDQUFDO0lBQ3RFLENBQUM7SUFFRCxNQUFNLENBQUMsVUFBVSxDQUFDLEtBQXdCO1FBQ3hDLE9BQU8sNkJBQVksQ0FBQyxrQkFBa0IsQ0FBQyxzQ0FBeUIsRUFBRSxLQUFLLENBQUMsQ0FBQztJQUMzRSxDQUFDO0NBQ0Y7QUF4QkQsc0NBd0JDIn0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/controller-decorator",
-  "version": "3.72.0",
+  "version": "3.73.0-beta.1",
   "description": "tegg controller decorator",
   "keywords": [
     "egg",
@@ -37,12 +37,12 @@
     "node": ">=14.0.0"
   },
   "dependencies": {
-    "@eggjs/aop-decorator": "^3.72.0",
+    "@eggjs/aop-decorator": "^3.73.0-beta.1",
     "@eggjs/cookies": "^3.0.1",
-    "@eggjs/core-decorator": "^3.72.0",
-    "@eggjs/tegg-common-util": "^3.72.0",
-    "@eggjs/tegg-metadata": "^3.72.0",
-    "@eggjs/tegg-types": "^3.72.0",
+    "@eggjs/core-decorator": "^3.73.0-beta.1",
+    "@eggjs/tegg-common-util": "^3.73.0-beta.1",
+    "@eggjs/tegg-metadata": "^3.73.0-beta.1",
+    "@eggjs/tegg-types": "^3.73.0-beta.1",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "is-type-of": "^1.2.1",
     "path-to-regexp": "^1.8.0",
@@ -62,5 +62,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "59695249c411a9edf316a12efe580a3b3aedab6a"
+  "gitHead": "b29319ee49b55f6e777d5581d70bfea224bf6e1f"
 }