@eggjs/tegg-types 4.0.2-beta.16 → 4.0.2-beta.17

package/dist/index.d.ts

@@ -77,6 +77,7 @@ import { EggObjectLifecycle, LifecycleHookName } from "./lifecycle/EggObjectLife
 import { Id, IdenticalObject } from "./lifecycle/IdenticalObject.js";
 import { LifecycleContext, LifecycleHook, LifecycleObject } from "./lifecycle/LifecycleHook.js";
 import { AttributeOptions, IS_MODEL, IndexOptions, MODEL_DATA_ATTRIBUTES, MODEL_DATA_INDICES, MODEL_DATA_SOURCE, MODEL_DATA_TABLE_NAME, MODEL_PROTO_IMPL_TYPE, ModelAttributeInfo, ModelIndexInfo, ModelParams } from "./orm.js";
+import { TeggScope, TeggScopeBag } from "./scope/TeggScope.js";
 import { CronParams, CronScheduleParams, IS_SCHEDULE, IntervalParams, IntervalScheduleParams, SCHEDULE_METADATA, SCHEDULE_OPTIONS, SCHEDULE_PARAMS, ScheduleOptions, ScheduleParams, ScheduleSubscriber, ScheduleType, ScheduleTypeLike } from "./schedule.js";
 import { IS_TRANSACTION_CLAZZ, PropagationType, TRANSACTION_META_DATA, TransactionMetadata, TransactionalParams } from "./transaction.js";
-export { AGENT_CONTROLLER_PROTO_IMPL_TYPE, ASPECT_LIST, AccessLevel, AdviceContext, AdviceInfo, AgentConflictError, AgentErrorCode, AgentInvalidRequestError, AgentMessage, AgentNotFoundError, AgentObjectType, AgentRunConfig, AgentStore, AgentTimeoutError, AspectAdvice, AttributeOptions, BaseDaoType, BaseMultiInstancePrototypeCallbackParams, BaseSpatialParams, BaseSqlMap, BigIntParams, BinaryParams, BitParams, BlobParams, BlockSqlMap, BoolParams, CONSTRUCTOR_QUALIFIER_META_DATA, CONTROLLER_ACL, CONTROLLER_AGENT_CONTROLLER, CONTROLLER_AGENT_ENHANCED, CONTROLLER_AGENT_NOT_IMPLEMENTED, CONTROLLER_AOP_MIDDLEWARES, CONTROLLER_HOST, CONTROLLER_HTTP_PATH, CONTROLLER_MCP_CONTROLLER_PARAMS_MAP, CONTROLLER_MCP_EXTRA_INDEX, CONTROLLER_MCP_NAME, CONTROLLER_MCP_PROMPT_ARGS_INDEX, CONTROLLER_MCP_PROMPT_MAP, CONTROLLER_MCP_PROMPT_PARAMS_MAP, CONTROLLER_MCP_RESOURCE_MAP, CONTROLLER_MCP_RESOURCE_PARAMS_MAP, CONTROLLER_MCP_TOOL_ARGS_INDEX, CONTROLLER_MCP_TOOL_MAP, CONTROLLER_MCP_TOOL_PARAMS_MAP, CONTROLLER_MCP_VERSION, CONTROLLER_META_DATA, CONTROLLER_METHOD_METHOD_MAP, CONTROLLER_METHOD_PARAM_NAME_MAP, CONTROLLER_METHOD_PARAM_TYPE_MAP, CONTROLLER_METHOD_PATH_MAP, CONTROLLER_METHOD_PRIORITY, CONTROLLER_MIDDLEWARES, CONTROLLER_NAME, CONTROLLER_TIMEOUT_METADATA, CONTROLLER_TYPE, CROSSCUT_INFO_LIST, CharParams, ClassCrosscutParam, CodeGeneratorOptions, ColumnFormat, ColumnParams, ColumnTsType, ColumnType, ColumnTypeParams, CompressionType, ConfigSourceQualifierAttribute, ContainerGetMethod, ContextProtoParams, ControllerMetaBuilder, ControllerMetaBuilderCreator, ControllerMetadata, ControllerType, ControllerTypeLike, CreateObjectMethod, CreateRunInput, CreateThreadOptions, CronParams, CronScheduleParams, CrosscutInfo, CrosscutOptions, CrosscutParam, CustomCrosscutParam, CustomPointcutCallback, DAL_COLUMN_INFO_MAP, DAL_COLUMN_TYPE_MAP, DAL_INDEX_LIST, DAL_IS_DAO, DAL_IS_TABLE, DAL_TABLE_PARAMS, DEFAULT_PROTO_IMPL_TYPE, DataSource, DataSourceInjectName, DataSourceQualifierAttribute, DateParams, DateTimeParams, DecimalParams, DoubleParams, EggAbstractClazz, EggContainer, EggContext, EggContextLifecycleContext, EggLoadUnitType, EggLoadUnitTypeLike, EggMultiInstanceCallbackPrototypeInfo, EggMultiInstancePrototypeInfo, EggObject, EggObjectFactory, EggObjectLifeCycleContext, EggObjectLifecycle, EggObjectName, EggObjectStatus, EggProtoImplClass, EggPrototype, EggPrototypeClass, EggPrototypeCreator, EggPrototypeInfo, EggPrototypeLifecycleContext, EggPrototypeName, EggPrototypeWithClazz, EggQualifierAttribute, EggRuntimeContext, EggType, EnumParams, EnvType, ErrorCodes, FloatParams, FullSqlMap, GenerateSqlMap, GenericInputContentPart, Geometry, GeometryCollection, GeometryCollectionParams, GeometryParams, GetThreadOptions, GraphNodeObj, HTTPControllerParams, HTTPMethodEnum, HTTPMethodParams, HTTPParamParams, HTTPParamType, HTTPQueriesParams, HTTPQueryParams, HostType, IAdvice, IColumnTypeParams, INIT_TYPE_TRY_ORDER, IS_CROSSCUT_ADVICE, IS_MODEL, IS_SCHEDULE, IS_TRANSACTION_CLAZZ, Id, IdenticalObject, ImplDecorator, ImplTypeEnum, IncomingHttpHeaders, IndexOptions, IndexParams, IndexStoreType, IndexType, InitTypeQualifierAttribute, InjectConstructor, InjectConstructorInfo, InjectConstructorProto, InjectObject, InjectObjectDescriptor, InjectObjectInfo, InjectObjectProto, InjectParams, InjectType, InlineModuleReferenceConfig, InputContentPart, InputMessage, InsertMethod, IntParams, IntervalParams, IntervalScheduleParams, InvalidRunStateTransitionError, JsonParams, LifecycleContext, LifecycleHook, LifecycleHookName, LifecycleObject, Line, LinestringParams, LoadUnit, LoadUnitCreator, LoadUnitInstance, LoadUnitInstanceLifecycleContext, LoadUnitLifecycleContext, LoadUnitNameQualifierAttribute, LoadUnitPair, Loader, Logger, LongBlobParams, LongTextParams, MCPControllerParams, MCPPromptParams, MCPPromptResponse, MCPProtocols, MCPResourceParams, MCPResourceResponse, MCPResourceTemplateParams, MCPResourceUriParams, MCPToolParams, MCPToolResponse, METHOD_ACL, METHOD_AOP_MIDDLEWARES, METHOD_AOP_REGISTER_MAP, METHOD_CONTEXT_INDEX, METHOD_CONTROLLER_HOST, METHOD_CONTROLLER_TYPE_MAP, METHOD_MIDDLEWARES, METHOD_TIMEOUT_METADATA, MODEL_DATA_ATTRIBUTES, MODEL_DATA_INDICES, MODEL_DATA_SOURCE, MODEL_DATA_TABLE_NAME, MODEL_PROTO_IMPL_TYPE, MediumBlobParams, MediumIntParams, MediumTextParams, MetaDataKey, MethodMeta, MethodType, MethodTypeLike, MiddlewareFunc, ModelAttributeInfo, ModelIndexInfo, ModelParams, ModuleConfig, ModuleConfigHolder, ModuleReference, ModuleReferenceConfig, MultiInstancePrototypeCallbackParams, MultiInstancePrototypeGetObjectsContext, MultiInstancePrototypeParams, MultiInstancePrototypeStaticParams, MultiInstanceType, MultiLine, MultiLinestringParams, MultiPoint, MultiPointParams, MultiPolygon, MultiPolygonParams, NameCrosscutParam, Next, NpmModuleReferenceConfig, ObjectInfo, ObjectInitType, ObjectInitTypeLike, ObjectStorageClient, POINTCUT_ADVICE_INFO_LIAR, PROPERTY_QUALIFIER_META_DATA, PaginateData, Point, PointParams, PointcutInfo, PointcutOptions, PointcutType, Polygon, PolygonParams, PromptArgs, PromptExtra, PropagationType, ProtoDescriptor, ProtoDescriptorType, ProtoDescriptorTypeLike, PrototypeParams, QUALIFIER_IMPL_MAP, QUALIFIER_META_DATA, QualifierAttribute, QualifierInfo, QualifierValue, ReadModuleReferenceOptions, ResourceExtra, ResourceVariables, RowFormat, RunObject, RunRecord, RunStatus, RuntimeConfig, SCHEDULE_METADATA, SCHEDULE_OPTIONS, SCHEDULE_PARAMS, SDKAssistantMessage, SDKGenericMessage, SDKResultMessage, SDKStreamEvent, SDKSystemMessage, SDKUserMessage, ScheduleOptions, ScheduleParams, ScheduleSubscriber, ScheduleType, ScheduleTypeLike, SetParams, SingletonProtoParams, SmallIntParams, SqlMap, SqlType, StreamEvent, TRANSACTION_META_DATA, TableParams, Templates, TextInputContentPart, TextParams, ThreadObject, ThreadObjectWithMessages, ThreadRecord, TimeParams, TimestampParams, TinyBlobParams, TinyIntParams, TinyTextParams, ToolArgs, ToolExtra, ToolResultInputContentPart, ToolUseInputContentPart, TransactionMetadata, TransactionalParams, VarBinaryParams, VarCharParams, YearParams };
+export { AGENT_CONTROLLER_PROTO_IMPL_TYPE, ASPECT_LIST, AccessLevel, AdviceContext, AdviceInfo, AgentConflictError, AgentErrorCode, AgentInvalidRequestError, AgentMessage, AgentNotFoundError, AgentObjectType, AgentRunConfig, AgentStore, AgentTimeoutError, AspectAdvice, AttributeOptions, BaseDaoType, BaseMultiInstancePrototypeCallbackParams, BaseSpatialParams, BaseSqlMap, BigIntParams, BinaryParams, BitParams, BlobParams, BlockSqlMap, BoolParams, CONSTRUCTOR_QUALIFIER_META_DATA, CONTROLLER_ACL, CONTROLLER_AGENT_CONTROLLER, CONTROLLER_AGENT_ENHANCED, CONTROLLER_AGENT_NOT_IMPLEMENTED, CONTROLLER_AOP_MIDDLEWARES, CONTROLLER_HOST, CONTROLLER_HTTP_PATH, CONTROLLER_MCP_CONTROLLER_PARAMS_MAP, CONTROLLER_MCP_EXTRA_INDEX, CONTROLLER_MCP_NAME, CONTROLLER_MCP_PROMPT_ARGS_INDEX, CONTROLLER_MCP_PROMPT_MAP, CONTROLLER_MCP_PROMPT_PARAMS_MAP, CONTROLLER_MCP_RESOURCE_MAP, CONTROLLER_MCP_RESOURCE_PARAMS_MAP, CONTROLLER_MCP_TOOL_ARGS_INDEX, CONTROLLER_MCP_TOOL_MAP, CONTROLLER_MCP_TOOL_PARAMS_MAP, CONTROLLER_MCP_VERSION, CONTROLLER_META_DATA, CONTROLLER_METHOD_METHOD_MAP, CONTROLLER_METHOD_PARAM_NAME_MAP, CONTROLLER_METHOD_PARAM_TYPE_MAP, CONTROLLER_METHOD_PATH_MAP, CONTROLLER_METHOD_PRIORITY, CONTROLLER_MIDDLEWARES, CONTROLLER_NAME, CONTROLLER_TIMEOUT_METADATA, CONTROLLER_TYPE, CROSSCUT_INFO_LIST, CharParams, ClassCrosscutParam, CodeGeneratorOptions, ColumnFormat, ColumnParams, ColumnTsType, ColumnType, ColumnTypeParams, CompressionType, ConfigSourceQualifierAttribute, ContainerGetMethod, ContextProtoParams, ControllerMetaBuilder, ControllerMetaBuilderCreator, ControllerMetadata, ControllerType, ControllerTypeLike, CreateObjectMethod, CreateRunInput, CreateThreadOptions, CronParams, CronScheduleParams, CrosscutInfo, CrosscutOptions, CrosscutParam, CustomCrosscutParam, CustomPointcutCallback, DAL_COLUMN_INFO_MAP, DAL_COLUMN_TYPE_MAP, DAL_INDEX_LIST, DAL_IS_DAO, DAL_IS_TABLE, DAL_TABLE_PARAMS, DEFAULT_PROTO_IMPL_TYPE, DataSource, DataSourceInjectName, DataSourceQualifierAttribute, DateParams, DateTimeParams, DecimalParams, DoubleParams, EggAbstractClazz, EggContainer, EggContext, EggContextLifecycleContext, EggLoadUnitType, EggLoadUnitTypeLike, EggMultiInstanceCallbackPrototypeInfo, EggMultiInstancePrototypeInfo, EggObject, EggObjectFactory, EggObjectLifeCycleContext, EggObjectLifecycle, EggObjectName, EggObjectStatus, EggProtoImplClass, EggPrototype, EggPrototypeClass, EggPrototypeCreator, EggPrototypeInfo, EggPrototypeLifecycleContext, EggPrototypeName, EggPrototypeWithClazz, EggQualifierAttribute, EggRuntimeContext, EggType, EnumParams, EnvType, ErrorCodes, FloatParams, FullSqlMap, GenerateSqlMap, GenericInputContentPart, Geometry, GeometryCollection, GeometryCollectionParams, GeometryParams, GetThreadOptions, GraphNodeObj, HTTPControllerParams, HTTPMethodEnum, HTTPMethodParams, HTTPParamParams, HTTPParamType, HTTPQueriesParams, HTTPQueryParams, HostType, IAdvice, IColumnTypeParams, INIT_TYPE_TRY_ORDER, IS_CROSSCUT_ADVICE, IS_MODEL, IS_SCHEDULE, IS_TRANSACTION_CLAZZ, Id, IdenticalObject, ImplDecorator, ImplTypeEnum, IncomingHttpHeaders, IndexOptions, IndexParams, IndexStoreType, IndexType, InitTypeQualifierAttribute, InjectConstructor, InjectConstructorInfo, InjectConstructorProto, InjectObject, InjectObjectDescriptor, InjectObjectInfo, InjectObjectProto, InjectParams, InjectType, InlineModuleReferenceConfig, InputContentPart, InputMessage, InsertMethod, IntParams, IntervalParams, IntervalScheduleParams, InvalidRunStateTransitionError, JsonParams, LifecycleContext, LifecycleHook, LifecycleHookName, LifecycleObject, Line, LinestringParams, LoadUnit, LoadUnitCreator, LoadUnitInstance, LoadUnitInstanceLifecycleContext, LoadUnitLifecycleContext, LoadUnitNameQualifierAttribute, LoadUnitPair, Loader, Logger, LongBlobParams, LongTextParams, MCPControllerParams, MCPPromptParams, MCPPromptResponse, MCPProtocols, MCPResourceParams, MCPResourceResponse, MCPResourceTemplateParams, MCPResourceUriParams, MCPToolParams, MCPToolResponse, METHOD_ACL, METHOD_AOP_MIDDLEWARES, METHOD_AOP_REGISTER_MAP, METHOD_CONTEXT_INDEX, METHOD_CONTROLLER_HOST, METHOD_CONTROLLER_TYPE_MAP, METHOD_MIDDLEWARES, METHOD_TIMEOUT_METADATA, MODEL_DATA_ATTRIBUTES, MODEL_DATA_INDICES, MODEL_DATA_SOURCE, MODEL_DATA_TABLE_NAME, MODEL_PROTO_IMPL_TYPE, MediumBlobParams, MediumIntParams, MediumTextParams, MetaDataKey, MethodMeta, MethodType, MethodTypeLike, MiddlewareFunc, ModelAttributeInfo, ModelIndexInfo, ModelParams, ModuleConfig, ModuleConfigHolder, ModuleReference, ModuleReferenceConfig, MultiInstancePrototypeCallbackParams, MultiInstancePrototypeGetObjectsContext, MultiInstancePrototypeParams, MultiInstancePrototypeStaticParams, MultiInstanceType, MultiLine, MultiLinestringParams, MultiPoint, MultiPointParams, MultiPolygon, MultiPolygonParams, NameCrosscutParam, Next, NpmModuleReferenceConfig, ObjectInfo, ObjectInitType, ObjectInitTypeLike, ObjectStorageClient, POINTCUT_ADVICE_INFO_LIAR, PROPERTY_QUALIFIER_META_DATA, PaginateData, Point, PointParams, PointcutInfo, PointcutOptions, PointcutType, Polygon, PolygonParams, PromptArgs, PromptExtra, PropagationType, ProtoDescriptor, ProtoDescriptorType, ProtoDescriptorTypeLike, PrototypeParams, QUALIFIER_IMPL_MAP, QUALIFIER_META_DATA, QualifierAttribute, QualifierInfo, QualifierValue, ReadModuleReferenceOptions, ResourceExtra, ResourceVariables, RowFormat, RunObject, RunRecord, RunStatus, RuntimeConfig, SCHEDULE_METADATA, SCHEDULE_OPTIONS, SCHEDULE_PARAMS, SDKAssistantMessage, SDKGenericMessage, SDKResultMessage, SDKStreamEvent, SDKSystemMessage, SDKUserMessage, ScheduleOptions, ScheduleParams, ScheduleSubscriber, ScheduleType, ScheduleTypeLike, SetParams, SingletonProtoParams, SmallIntParams, SqlMap, SqlType, StreamEvent, TRANSACTION_META_DATA, TableParams, TeggScope, TeggScopeBag, Templates, TextInputContentPart, TextParams, ThreadObject, ThreadObjectWithMessages, ThreadRecord, TimeParams, TimestampParams, TinyBlobParams, TinyIntParams, TinyTextParams, ToolArgs, ToolExtra, ToolResultInputContentPart, ToolUseInputContentPart, TransactionMetadata, TransactionalParams, VarBinaryParams, VarCharParams, YearParams };

package/dist/index.js

@@ -32,10 +32,12 @@ import { ProtoDescriptorType } from "./metadata/enum/ProtoDescriptorType.js";
 import "./metadata/index.js";
 import { IS_MODEL, MODEL_DATA_ATTRIBUTES, MODEL_DATA_INDICES, MODEL_DATA_SOURCE, MODEL_DATA_TABLE_NAME, MODEL_PROTO_IMPL_TYPE } from "./orm.js";
 import { EggObjectStatus } from "./runtime/model/EggObject.js";
+import { TeggScope } from "./scope/TeggScope.js";
+import "./scope/index.js";
 import { IS_SCHEDULE, SCHEDULE_METADATA, SCHEDULE_OPTIONS, SCHEDULE_PARAMS, ScheduleType } from "./schedule.js";
 import { IS_TRANSACTION_CLAZZ, PropagationType, TRANSACTION_META_DATA } from "./transaction.js";
 import { AgentObjectType, RunStatus } from "./agent-runtime/AgentStore.js";
 import { AgentErrorCode } from "./agent-runtime/AgentRuntime.js";
 import { AgentConflictError, AgentInvalidRequestError, AgentNotFoundError, AgentTimeoutError, InvalidRunStateTransitionError } from "./agent-runtime/errors.js";
 
-export { AGENT_CONTROLLER_PROTO_IMPL_TYPE, ASPECT_LIST, AccessLevel, AgentConflictError, AgentErrorCode, AgentInvalidRequestError, AgentNotFoundError, AgentObjectType, AgentTimeoutError, CONSTRUCTOR_QUALIFIER_META_DATA, CONTROLLER_ACL, CONTROLLER_AGENT_CONTROLLER, CONTROLLER_AGENT_ENHANCED, CONTROLLER_AGENT_NOT_IMPLEMENTED, CONTROLLER_AOP_MIDDLEWARES, CONTROLLER_HOST, CONTROLLER_HTTP_PATH, CONTROLLER_MCP_CONTROLLER_PARAMS_MAP, CONTROLLER_MCP_EXTRA_INDEX, CONTROLLER_MCP_NAME, CONTROLLER_MCP_PROMPT_ARGS_INDEX, CONTROLLER_MCP_PROMPT_MAP, CONTROLLER_MCP_PROMPT_PARAMS_MAP, CONTROLLER_MCP_RESOURCE_MAP, CONTROLLER_MCP_RESOURCE_PARAMS_MAP, CONTROLLER_MCP_TOOL_ARGS_INDEX, CONTROLLER_MCP_TOOL_MAP, CONTROLLER_MCP_TOOL_PARAMS_MAP, CONTROLLER_MCP_VERSION, CONTROLLER_META_DATA, CONTROLLER_METHOD_METHOD_MAP, CONTROLLER_METHOD_PARAM_NAME_MAP, CONTROLLER_METHOD_PARAM_TYPE_MAP, CONTROLLER_METHOD_PATH_MAP, CONTROLLER_METHOD_PRIORITY, CONTROLLER_MIDDLEWARES, CONTROLLER_NAME, CONTROLLER_TIMEOUT_METADATA, CONTROLLER_TYPE, CROSSCUT_INFO_LIST, ColumnFormat, ColumnType, CompressionType, ConfigSourceQualifierAttribute, ControllerType, DAL_COLUMN_INFO_MAP, DAL_COLUMN_TYPE_MAP, DAL_INDEX_LIST, DAL_IS_DAO, DAL_IS_TABLE, DAL_TABLE_PARAMS, DEFAULT_PROTO_IMPL_TYPE, DataSourceInjectName, DataSourceQualifierAttribute, EggLoadUnitType, EggObjectStatus, EggQualifierAttribute, EggType, ErrorCodes, HTTPMethodEnum, HTTPParamType, INIT_TYPE_TRY_ORDER, IS_CROSSCUT_ADVICE, IS_MODEL, IS_SCHEDULE, IS_TRANSACTION_CLAZZ, IndexStoreType, IndexType, InitTypeQualifierAttribute, InjectType, InsertMethod, InvalidRunStateTransitionError, LoadUnitNameQualifierAttribute, MCPProtocols, METHOD_ACL, METHOD_AOP_MIDDLEWARES, METHOD_AOP_REGISTER_MAP, METHOD_CONTEXT_INDEX, METHOD_CONTROLLER_HOST, METHOD_CONTROLLER_TYPE_MAP, METHOD_MIDDLEWARES, METHOD_TIMEOUT_METADATA, MODEL_DATA_ATTRIBUTES, MODEL_DATA_INDICES, MODEL_DATA_SOURCE, MODEL_DATA_TABLE_NAME, MODEL_PROTO_IMPL_TYPE, MethodType, MultiInstanceType, ObjectInitType, POINTCUT_ADVICE_INFO_LIAR, PROPERTY_QUALIFIER_META_DATA, PointcutType, PropagationType, ProtoDescriptorType, QUALIFIER_IMPL_MAP, QUALIFIER_META_DATA, RowFormat, RunStatus, SCHEDULE_METADATA, SCHEDULE_OPTIONS, SCHEDULE_PARAMS, ScheduleType, SqlType, TRANSACTION_META_DATA, Templates };
+export { AGENT_CONTROLLER_PROTO_IMPL_TYPE, ASPECT_LIST, AccessLevel, AgentConflictError, AgentErrorCode, AgentInvalidRequestError, AgentNotFoundError, AgentObjectType, AgentTimeoutError, CONSTRUCTOR_QUALIFIER_META_DATA, CONTROLLER_ACL, CONTROLLER_AGENT_CONTROLLER, CONTROLLER_AGENT_ENHANCED, CONTROLLER_AGENT_NOT_IMPLEMENTED, CONTROLLER_AOP_MIDDLEWARES, CONTROLLER_HOST, CONTROLLER_HTTP_PATH, CONTROLLER_MCP_CONTROLLER_PARAMS_MAP, CONTROLLER_MCP_EXTRA_INDEX, CONTROLLER_MCP_NAME, CONTROLLER_MCP_PROMPT_ARGS_INDEX, CONTROLLER_MCP_PROMPT_MAP, CONTROLLER_MCP_PROMPT_PARAMS_MAP, CONTROLLER_MCP_RESOURCE_MAP, CONTROLLER_MCP_RESOURCE_PARAMS_MAP, CONTROLLER_MCP_TOOL_ARGS_INDEX, CONTROLLER_MCP_TOOL_MAP, CONTROLLER_MCP_TOOL_PARAMS_MAP, CONTROLLER_MCP_VERSION, CONTROLLER_META_DATA, CONTROLLER_METHOD_METHOD_MAP, CONTROLLER_METHOD_PARAM_NAME_MAP, CONTROLLER_METHOD_PARAM_TYPE_MAP, CONTROLLER_METHOD_PATH_MAP, CONTROLLER_METHOD_PRIORITY, CONTROLLER_MIDDLEWARES, CONTROLLER_NAME, CONTROLLER_TIMEOUT_METADATA, CONTROLLER_TYPE, CROSSCUT_INFO_LIST, ColumnFormat, ColumnType, CompressionType, ConfigSourceQualifierAttribute, ControllerType, DAL_COLUMN_INFO_MAP, DAL_COLUMN_TYPE_MAP, DAL_INDEX_LIST, DAL_IS_DAO, DAL_IS_TABLE, DAL_TABLE_PARAMS, DEFAULT_PROTO_IMPL_TYPE, DataSourceInjectName, DataSourceQualifierAttribute, EggLoadUnitType, EggObjectStatus, EggQualifierAttribute, EggType, ErrorCodes, HTTPMethodEnum, HTTPParamType, INIT_TYPE_TRY_ORDER, IS_CROSSCUT_ADVICE, IS_MODEL, IS_SCHEDULE, IS_TRANSACTION_CLAZZ, IndexStoreType, IndexType, InitTypeQualifierAttribute, InjectType, InsertMethod, InvalidRunStateTransitionError, LoadUnitNameQualifierAttribute, MCPProtocols, METHOD_ACL, METHOD_AOP_MIDDLEWARES, METHOD_AOP_REGISTER_MAP, METHOD_CONTEXT_INDEX, METHOD_CONTROLLER_HOST, METHOD_CONTROLLER_TYPE_MAP, METHOD_MIDDLEWARES, METHOD_TIMEOUT_METADATA, MODEL_DATA_ATTRIBUTES, MODEL_DATA_INDICES, MODEL_DATA_SOURCE, MODEL_DATA_TABLE_NAME, MODEL_PROTO_IMPL_TYPE, MethodType, MultiInstanceType, ObjectInitType, POINTCUT_ADVICE_INFO_LIAR, PROPERTY_QUALIFIER_META_DATA, PointcutType, PropagationType, ProtoDescriptorType, QUALIFIER_IMPL_MAP, QUALIFIER_META_DATA, RowFormat, RunStatus, SCHEDULE_METADATA, SCHEDULE_OPTIONS, SCHEDULE_PARAMS, ScheduleType, SqlType, TRANSACTION_META_DATA, TeggScope, Templates };

package/dist/scope/TeggScope.d.ts

@@ -0,0 +1,82 @@
+//#region src/scope/TeggScope.d.ts
+/**
+* The per-app scope "bag": a type-free container keyed by per-package symbols.
+*
+* Each tegg package defines its own slot {@link symbol} and its own concrete
+* fallback, and reads/writes ONLY its own slot. No package imports another
+* package's slot — the bag is the single shared, type-agnostic carrier. The
+* aggregating "TeggRuntime" convenience that knows the concrete types lives in a
+* higher layer (plugin/tegg, standalone Runner) where importing metadata +
+* runtime is legal; it builds the bag and wraps boot/request in
+* {@link TeggScope.run}.
+*/
+type TeggScopeBag = Map<symbol, unknown>;
+/**
+* Type-free, lowest-level async scope container for tegg multi-app isolation.
+*
+* It owns ONLY the AsyncLocalStorage, the scope counter, and the strict-mode
+* escape fuse. It knows nothing about concrete factories/managers — those are
+* resolved by each package via {@link TeggScope.resolve} / {@link TeggScope.getOr}
+* against its own slot.
+*/
+declare class TeggScope {
+  #private;
+  /** The bag for the currently active async scope, if any. */
+  static current(): TeggScopeBag | undefined;
+  /** Run `fn` with `bag` as the active scope. Synchronous or async `fn`. */
+  static run<R>(bag: TeggScopeBag, fn: () => R): R;
+  /**
+  * Run `fn` in `bag`'s scope when a bag is provided, otherwise run it directly
+  * in whatever scope is already active (the bag may not be established yet during
+  * very early boot). Centralizes the per-app `bag ? run(bag, fn) : fn()` idiom.
+  */
+  static runMaybe<R>(bag: TeggScopeBag | undefined, fn: () => R): R;
+  /** Create a fresh, empty per-app bag. */
+  static createBag(): TeggScopeBag;
+  /**
+  * Mark that an explicit per-app scope has been established (boot), tracking the
+  * app's bag so that — while it is the sole live app — no-scope access resolves
+  * to it instead of a separate process-default bag.
+  */
+  static registerScope(bag: TeggScopeBag): void;
+  /** Mark that a previously-established per-app scope has been torn down (close). */
+  static unregisterScope(bag: TeggScopeBag): void;
+  /** True when more than one app scope is alive — genuine multi-app mode. */
+  static get isMultiApp(): boolean;
+  /** Number of live explicit app scopes. */
+  static get scopeCount(): number;
+  /**
+  * Resolve a lazily-materialized per-app singleton (factory / manager / cache).
+  *
+  * - inside a scope: lazily create via `create()` and memoize in the active bag;
+  * - no scope: lazily create+memoize in the single process-default bag
+  *   (single-app lazy default). Under multi-app, hitting the default bag is
+  *   reported as an escape (dev throw / prod warn).
+  *
+  * `create()` may reference sibling slots' static facades (e.g. `X.instance`);
+  * because they resolve against the SAME bag, cross-slot dependencies stay
+  * consistent in both scoped and default modes.
+  */
+  static resolve<T>(slot: symbol, create: () => T, desc: string): T;
+  /**
+  * Read a "set later, may be undefined" slot (e.g. globalGraph, context
+  * callbacks). The active bag (scoped, or the single process-default bag) is the
+  * source of truth; `legacy()` only supplies the initial value before any set.
+  */
+  static getOr<T>(slot: symbol, legacy: () => T | undefined, desc: string): T | undefined;
+  /**
+  * Write a slot into the active bag (scoped, or the single process-default bag).
+  * Always succeeds; returns true for symmetry with earlier call sites.
+  *
+  * Like {@link TeggScope.resolve} / {@link TeggScope.getOr}, a write that escapes
+  * to the process-default bag under multi-app mode is reported, so a missed
+  * scope wrap that silently mutates shared state is caught instead of leaking.
+  */
+  static set(slot: symbol, value: unknown): boolean;
+  /** @internal Reset the process-default bag (e.g. between tests). */
+  static _resetDefaultBag(): void;
+  /** @internal The current process-default bag, if any. */
+  static _getDefaultBag(): TeggScopeBag | undefined;
+}
+//#endregion
+export { TeggScope, TeggScopeBag };

package/dist/scope/TeggScope.js

@@ -0,0 +1,162 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/scope/TeggScope.ts
+const als = new AsyncLocalStorage();
+/**
+* Bags of the app scopes currently alive in the process. Each tegg app/Runner
+* adds its bag at boot ({@link TeggScope.registerScope}) and removes it at close
+* ({@link TeggScope.unregisterScope}).
+*
+* The set size is the live-app count that drives the strict-mode escape fuse:
+* while MORE THAN ONE app is alive (true multi-app), falling back to the
+* process-default bag is treated as a scope escape bug. When EXACTLY ONE app is
+* alive, that app's bag is also the no-scope fallback (see {@link
+* TeggScope.#fallbackBag}) — single-app code running outside an explicit
+* {@link TeggScope.run} (direct singleton/ContextProto calls, detached loggers)
+* resolves the very slots the app populated at boot, matching the pre-scoping
+* process-global behavior. With a single app (or none) the silent lazy default
+* is kept so existing single-app code and tests are unaffected.
+*/
+const liveScopeBags = /* @__PURE__ */ new Set();
+/**
+* Process-wide default bag, used when NO app scope is the active/sole storage,
+* i.e. zero apps alive (pure tegg-core unit tests / standalone helpers) or, under
+* multi-app, the escape path. Created on demand so every fallback slot lands in
+* the SAME bag and stays cross-consistent (e.g. a factory created in the default
+* bag references the lifecycle util also in the default bag). Tests may
+* install/reset it explicitly.
+*/
+let defaultBag;
+function isProduction() {
+	const serverEnv = process.env.EGG_SERVER_ENV;
+	if (serverEnv) return serverEnv === "prod";
+	return process.env.NODE_ENV === "production";
+}
+function reportEscape(desc) {
+	const err = /* @__PURE__ */ new Error(`[tegg] TeggScope escaped to the process-default bag under multi-app mode (${desc}). A per-app scope was expected but none is active — the access likely happened outside TeggScope.run(app scope, ...). This would cross-talk between apps.`);
+	if (!isProduction()) throw err;
+	console.warn(err.stack);
+}
+/**
+* Type-free, lowest-level async scope container for tegg multi-app isolation.
+*
+* It owns ONLY the AsyncLocalStorage, the scope counter, and the strict-mode
+* escape fuse. It knows nothing about concrete factories/managers — those are
+* resolved by each package via {@link TeggScope.resolve} / {@link TeggScope.getOr}
+* against its own slot.
+*/
+var TeggScope = class TeggScope {
+	/** The bag for the currently active async scope, if any. */
+	static current() {
+		return als.getStore();
+	}
+	/** Run `fn` with `bag` as the active scope. Synchronous or async `fn`. */
+	static run(bag, fn) {
+		return als.run(bag, fn);
+	}
+	/**
+	* Run `fn` in `bag`'s scope when a bag is provided, otherwise run it directly
+	* in whatever scope is already active (the bag may not be established yet during
+	* very early boot). Centralizes the per-app `bag ? run(bag, fn) : fn()` idiom.
+	*/
+	static runMaybe(bag, fn) {
+		return bag ? als.run(bag, fn) : fn();
+	}
+	/** Create a fresh, empty per-app bag. */
+	static createBag() {
+		return /* @__PURE__ */ new Map();
+	}
+	/**
+	* Mark that an explicit per-app scope has been established (boot), tracking the
+	* app's bag so that — while it is the sole live app — no-scope access resolves
+	* to it instead of a separate process-default bag.
+	*/
+	static registerScope(bag) {
+		liveScopeBags.add(bag);
+	}
+	/** Mark that a previously-established per-app scope has been torn down (close). */
+	static unregisterScope(bag) {
+		liveScopeBags.delete(bag);
+	}
+	/** True when more than one app scope is alive — genuine multi-app mode. */
+	static get isMultiApp() {
+		return liveScopeBags.size > 1;
+	}
+	/** Number of live explicit app scopes. */
+	static get scopeCount() {
+		return liveScopeBags.size;
+	}
+	/**
+	* The bag used when NO ALS scope is active. With exactly one app alive, that
+	* app's bag is the single-app effective storage, so out-of-scope access sees
+	* the slots boot populated. Zero apps (pure unit tests / standalone helpers) —
+	* or, under multi-app, the reported escape path — use the process-default bag.
+	*/
+	static #fallbackBag() {
+		if (liveScopeBags.size === 1) for (const bag of liveScopeBags) return bag;
+		return defaultBag ??= /* @__PURE__ */ new Map();
+	}
+	/**
+	* Resolve a lazily-materialized per-app singleton (factory / manager / cache).
+	*
+	* - inside a scope: lazily create via `create()` and memoize in the active bag;
+	* - no scope: lazily create+memoize in the single process-default bag
+	*   (single-app lazy default). Under multi-app, hitting the default bag is
+	*   reported as an escape (dev throw / prod warn).
+	*
+	* `create()` may reference sibling slots' static facades (e.g. `X.instance`);
+	* because they resolve against the SAME bag, cross-slot dependencies stay
+	* consistent in both scoped and default modes.
+	*/
+	static resolve(slot, create, desc) {
+		const bag = als.getStore();
+		if (bag) return TeggScope.#getOrCreate(bag, slot, create);
+		if (TeggScope.isMultiApp) reportEscape(desc);
+		return TeggScope.#getOrCreate(TeggScope.#fallbackBag(), slot, create);
+	}
+	/**
+	* Read a "set later, may be undefined" slot (e.g. globalGraph, context
+	* callbacks). The active bag (scoped, or the single process-default bag) is the
+	* source of truth; `legacy()` only supplies the initial value before any set.
+	*/
+	static getOr(slot, legacy, desc) {
+		const bag = als.getStore();
+		if (bag) return bag.has(slot) ? bag.get(slot) : legacy();
+		if (TeggScope.isMultiApp) reportEscape(desc);
+		const d = TeggScope.#fallbackBag();
+		return d.has(slot) ? d.get(slot) : legacy();
+	}
+	/**
+	* Write a slot into the active bag (scoped, or the single process-default bag).
+	* Always succeeds; returns true for symmetry with earlier call sites.
+	*
+	* Like {@link TeggScope.resolve} / {@link TeggScope.getOr}, a write that escapes
+	* to the process-default bag under multi-app mode is reported, so a missed
+	* scope wrap that silently mutates shared state is caught instead of leaking.
+	*/
+	static set(slot, value) {
+		const bag = als.getStore();
+		if (bag) {
+			bag.set(slot, value);
+			return true;
+		}
+		if (TeggScope.isMultiApp) reportEscape(slot.toString());
+		TeggScope.#fallbackBag().set(slot, value);
+		return true;
+	}
+	/** @internal Reset the process-default bag (e.g. between tests). */
+	static _resetDefaultBag() {
+		defaultBag = void 0;
+	}
+	/** @internal The current process-default bag, if any. */
+	static _getDefaultBag() {
+		return defaultBag;
+	}
+	static #getOrCreate(bag, slot, create) {
+		if (!bag.has(slot)) bag.set(slot, create());
+		return bag.get(slot);
+	}
+};
+
+//#endregion
+export { TeggScope };

package/dist/scope/index.d.ts

@@ -0,0 +1,2 @@
+import { TeggScope, TeggScopeBag } from "./TeggScope.js";
+export { TeggScope, TeggScopeBag };

package/dist/scope/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/tegg-types",
-  "version": "4.0.2-beta.16",
+  "version": "4.0.2-beta.17",
   "description": "tegg types",
   "keywords": [
     "egg",
@@ -124,6 +124,8 @@
     "./runtime/model/EggObject": "./dist/runtime/model/EggObject.js",
     "./runtime/model/LoadUnitInstance": "./dist/runtime/model/LoadUnitInstance.js",
     "./schedule": "./dist/schedule.js",
+    "./scope": "./dist/scope/index.js",
+    "./scope/TeggScope": "./dist/scope/TeggScope.js",
     "./transaction": "./dist/transaction.js",
     "./package.json": "./package.json"
   },
@@ -136,10 +138,10 @@
   "devDependencies": {
     "@types/node": "^24.10.2",
     "typescript": "^5.9.3",
-    "egg": "4.1.2-beta.16"
+    "egg": "4.1.2-beta.17"
   },
   "peerDependencies": {
-    "egg": "4.1.2-beta.16"
+    "egg": "4.1.2-beta.17"
   },
   "engines": {
     "node": ">=22.18.0"