@deepmaid/maid-logger 0.1.0-alpha.1 → 0.1.0-alpha.3

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@deepseek-ai+cosmokit@1.8.6/node_modules/@deepseek-ai/cosmokit/lib/types/misc.d.ts
+//#region ../../node_modules/.pnpm/@deepseek-ai+cosmokit@1.9.0/node_modules/@deepseek-ai/cosmokit/lib/types/misc.d.ts
 /** String/symbol keyed dictionary type. */
 type Dict<T = any, K extends string | symbol = string> = { [key in K]: T; };
 /** Wrap a value in `Promise`, preserving the resolved type of existing promises. */
@@ -83,7 +83,7 @@ declare namespace StandardSchemaV1 {
   type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.0.5_@deepseek-ai+cordis-plugin-include@1.0.10_@deepseek-ai+cordis-plugin-loader@1.0.6/node_modules/@deepseek-ai/cordis/lib/types/utils.d.ts
+//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.1.0_@deepseek-ai+cordis-plugin-include@1.1.0_@deepseek-ai+cordis-plugin-loader@1.1.0/node_modules/@deepseek-ai/cordis/lib/types/utils.d.ts
 /** Ordered collection of disposable values with O(1) deletion by value. */
 declare class DisposableList<T extends WeakKey> {
   private sn;
@@ -98,6 +98,7 @@ declare class DisposableList<T extends WeakKey> {
 /** Shared symbols used to avoid public property-name collisions. */
 declare const symbols: {
   shadow: symbol;
+  caller: symbol;
   receiver: symbol;
   original: symbol;
   metadata: symbol;
@@ -116,7 +117,7 @@ declare const symbols: {
   resolveConfig: typeof Service.resolveConfig;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.0.5_@deepseek-ai+cordis-plugin-include@1.0.10_@deepseek-ai+cordis-plugin-loader@1.0.6/node_modules/@deepseek-ai/cordis/lib/types/registry.d.ts
+//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.1.0_@deepseek-ai+cordis-plugin-include@1.1.0_@deepseek-ai+cordis-plugin-loader@1.1.0/node_modules/@deepseek-ai/cordis/lib/types/registry.d.ts
 /**
  * Service dependency declaration accepted by plugins and the `@Inject`
  * decorator.
@@ -308,7 +309,7 @@ declare class RegistryService {
   plugin(plugin: Plugin, config?: any, getOuterStack?: () => string[]): Fiber & PromiseLike<Fiber>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.0.5_@deepseek-ai+cordis-plugin-include@1.0.10_@deepseek-ai+cordis-plugin-loader@1.0.6/node_modules/@deepseek-ai/cordis/lib/types/reflect.d.ts
+//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.1.0_@deepseek-ai+cordis-plugin-include@1.1.0_@deepseek-ai+cordis-plugin-loader@1.1.0/node_modules/@deepseek-ai/cordis/lib/types/reflect.d.ts
 declare module './context.ts' {
   interface Context {
     /**
@@ -395,14 +396,21 @@ declare namespace Property {
 }
 /** Concrete service implementation record stored in the root reflect service. */
 interface Impl {
+  /** Unique identity of this provision. */
+  uid: number;
   /** The service name. */
   name: string;
-  /** The fiber that provided the service (owns its lifetime). */
-  fiber: Fiber;
+  /** The providing context, including its service isolation. */
+  ctx: Context;
+  /** Fibers retaining this implementation until their teardown finishes. */
+  dependents: Set<Fiber>;
+  /** Wake a provision disposer after its final dependent unloads. */
+  release?: () => void;
   /** The current service value. */
   value?: any;
   /** Optional availability predicate consulted before dependents may load. */
   check?: () => boolean;
+  isolate: symbol;
 }
 /**
  * Reflection and service-resolution layer installed as `ctx.reflect`.
@@ -418,6 +426,7 @@ declare class ReflectService {
   store: Dict<Impl, symbol>;
   /** Declared context properties (services and accessors), by name. */
   props: Dict<Property>;
+  private _implCounter;
   constructor(ctx: Context);
   /**
    * Read a service from the store without the inject requirement.
@@ -455,9 +464,8 @@ declare class ReflectService {
    *
    * @param names — the service names that changed.
    * @param filter — restricts notification to matching isolation scopes.
-   * @returns the fibers whose dependency state was refreshed.
    */
-  notify(names: string[], filter?: (ctx: Context, name: string) => boolean): Fiber[];
+  notify(names: string[], filter?: (ctx: Context, name: string) => boolean): void;
   /**
    * Define a computed context property backed by get/set hooks.
    *
@@ -492,7 +500,7 @@ declare class ReflectService {
   bind<T extends Function>(callback: T): T;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.0.5_@deepseek-ai+cordis-plugin-include@1.0.10_@deepseek-ai+cordis-plugin-loader@1.0.6/node_modules/@deepseek-ai/cordis/lib/types/fiber.d.ts
+//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.1.0_@deepseek-ai+cordis-plugin-include@1.1.0_@deepseek-ai+cordis-plugin-loader@1.1.0/node_modules/@deepseek-ai/cordis/lib/types/fiber.d.ts
 declare module './context.ts' {
   interface Context extends Pick<Fiber, 'effect'> {
     /** The fiber (plugin runtime instance) that owns this context. */
@@ -545,7 +553,7 @@ declare const enum FiberState {
 /**
  * Runtime instance of one plugin application.
  *
- * A fiber tracks dependency state, validated config, lifecycle effects, and
+ * A fiber tracks dependency state, raw and effective config, lifecycle effects, and
  * cleanup for the plugin context returned by `ctx.plugin()`.
  */
 declare class Fiber {
@@ -556,24 +564,28 @@ declare class Fiber {
   uid: number | null;
   /** The context this fiber's plugin runs in (extends the parent context). */
   readonly ctx: Context;
-  /** The validated plugin config (updated by `update()`). */
+  /** Raw plugin input retained for the next activation. */
   config: any;
-  /** The raw plugin config, re-resolved before each activation. */
-  _config: any;
   /** Current lifecycle state; transitions emit `internal/status`. */
   state: FiberState;
   /** Dispose this fiber: unload the plugin, then settle once cleanup finished. */
   readonly dispose: () => Promise<void>;
-  /** Snapshot of required service implementations while loaded; `undefined` otherwise. */
-  store: Dict<Impl> | undefined;
+  /** Required implementations retained through dependent teardown. */
+  committed: Readonly<Dict<Impl>> | undefined;
+  /** Service implementations owned by this fiber, including isolated provisions. */
+  readonly provisions: Set<Impl>;
   /** The in-flight load/unload transition, if one is currently running. */
   inertia: Promise<void> | undefined;
   readonly _hooks: Dict<DisposableList<Function>>;
   readonly _disposables: DisposableList<Disposable<any>>;
   protected context: Context;
   private _error;
+  private _revision;
+  private _configRevision;
+  private _effectiveConfig;
   private _runner;
   private _store;
+  private _release;
   /**
    * Create a fiber. Plugin authors normally obtain fibers from `ctx.plugin()`
    * rather than constructing them directly.
@@ -622,7 +634,25 @@ declare class Fiber {
   _checkImpl(name: string): boolean | undefined;
   _refresh(): void;
   private _setEpoch;
-  private _resolveConfig;
+  /** Raw input retained for the next activation, without evaluating expressions or validating it. */
+  get rawConfig(): unknown;
+  /** Retain raw input without changing the running config or triggering an update. */
+  set rawConfig(config: unknown);
+  /**
+   * The object passed to plugin activation or the latest successful update that retained the instance.
+   * Candidate resolution does not publish it; volatile updates retain its references.
+   * Undefined before activation and readable after unload; callers requiring a live instance check `state`.
+   */
+  get effectiveConfig(): unknown;
+  /**
+   * Evaluate and validate a candidate using this fiber's `internal/config` hooks and runtime schema.
+   * Does not publish the result, replace raw input, or commit running volatile references.
+   * Required injections must be available when a hook uses them.
+   * @param config Raw candidate input.
+   * @returns The candidate's resolved config, retaining the schema's result identity.
+   * @throws {ValidationError} when the runtime schema rejects the candidate; hook errors propagate.
+   */
+  resolveConfig(config: unknown): unknown;
   private _reload;
   private _unload;
   /**
@@ -640,20 +670,16 @@ declare class Fiber {
    */
   restart(): Promise<void>;
   /**
-   * Validate and apply new config, then restart the plugin.
-   *
-   * Runs the `internal/update` waterfall first, so update hooks (and HMR)
-   * can veto or replace the restart.
-   *
-   * @param config — the new raw config; validated before anything restarts.
-   * @param noSave — hint for persistence hooks not to write the change back.
-   * @returns nothing; the restart runs behind the `internal/update` waterfall.
-   * @throws {ValidationError} when the new config fails validation.
+   * Resolve a candidate, retain its raw config and apply it through the update waterfall.
+   * @param config Raw config; pending fibers defer resolution until activation.
+   * @param noSave Suppress the persistence notification when true.
+   * @returns The awaited update/restart result, or undefined when a synchronous listener handles it.
+   * @throws {ValidationError} when an active fiber's candidate is invalid.
    */
-  update(config: any, noSave?: boolean): void;
+  update(config: any, noSave?: boolean): Awaitable<void>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.0.5_@deepseek-ai+cordis-plugin-include@1.0.10_@deepseek-ai+cordis-plugin-loader@1.0.6/node_modules/@deepseek-ai/cordis/lib/types/events.d.ts
+//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.1.0_@deepseek-ai+cordis-plugin-include@1.1.0_@deepseek-ai+cordis-plugin-loader@1.1.0/node_modules/@deepseek-ai/cordis/lib/types/events.d.ts
 /** Extract the parameter tuple from a function type. */
 type Parameters<F> = F extends ((...args: infer P) => any) ? P : never;
 /** Extract the return type from a function type. */
@@ -765,12 +791,13 @@ declare class EventsService {
   private ctx;
   _hooks: Record<keyof any, Hook[]>;
   constructor(ctx: Context);
+  private _resolve;
   /**
-   * Resolve listeners for one dispatch and apply context filtering.
-   *
-   * @param type — the dispatch mode, reported on `internal/dispatch`.
-   * @param args — the raw dispatch arguments; consumed up to the event name.
-   * @returns the matching listener callbacks, bound to the dispatch `this`.
+   * Resolve bound callbacks using the event's context filter.
+   * @param type Dispatch mode reported to observers.
+   * @param args Dispatch arguments, consumed through the event name.
+   * @returns Matching callbacks bound to the dispatch receiver.
+   * DSH retains callback enumeration for per-listener error containment.
    */
   dispatch(type: string, args: any[]): ((...args: any[]) => any)[];
   /**
@@ -811,24 +838,8 @@ declare class EventsService {
    * @returns the outermost listener's return value.
    */
   waterfall(...args: any[]): any;
-  /**
-   * Store a listener record as an effect on the current fiber.
-   *
-   * @param label — effect label shown in fiber diagnostics.
-   * @param hooks — the listener list for one event.
-   * @param callback — the listener to store.
-   * @param options — placement and filtering options.
-   * @returns a disposer that unregisters the listener.
-   */
-  register(label: string, hooks: Hook[], callback: any, options: EventOptions): () => void;
-  /**
-   * Remove a stored listener record.
-   *
-   * @param hooks — the listener list for one event.
-   * @param callback — the listener to remove.
-   * @returns `true` if the listener was found and removed.
-   */
-  unregister(hooks: Hook[], callback: any): true | undefined;
+  private register;
+  private unregister;
   /**
    * Register an event listener owned by the current fiber.
    *
@@ -849,7 +860,7 @@ declare class EventsService {
    * @param options — listener options; a boolean is shorthand for `prepend`.
    * @returns a disposer removing the listener; `true` if it was still registered.
    */
-  once(name: string, listener: (...args: any) => any, options?: boolean | EventOptions): any;
+  once(name: string | symbol, listener: (...args: any) => any, options?: boolean | EventOptions): any;
 }
 /**
  * Built-in framework events used by core services and extension points.
@@ -860,20 +871,34 @@ declare class EventsService {
  * diagnostics before public events are delivered.
  */
 interface Events {
+  [key: symbol]: (...args: any[]) => any;
   /** A plugin fiber was created or its uid was cleared on disposal. */
   'internal/plugin'(fiber: Fiber): void;
   /** A fiber changed lifecycle state; receives the fiber and its previous state. */
   'internal/status'(fiber: Fiber, oldValue: FiberState): void;
+  /** A service binding was refreshed in the matching isolation scope. */
+  'internal/service'(this: Context, name: string, value: any): void;
   /**
-   * Resolve raw plugin config after the fiber's injections become active.
-   * @param config - the raw config for this activation.
+   * Apply resolved config; omitting `next()` keeps the current instance.
+   * @param resolvedConfig - the evaluated and validated candidate.
+   * @param next - restarts the fiber and waits for its lifecycle work.
    * @mode waterfall
    */
-  'internal/config'(this: Fiber, config: any, next: () => any): any;
-  /** Interception hook for a service binding (no core producer). */
-  'internal/service'(this: Context, name: string, value: any): void;
-  /** Waterfall: a fiber config update is being applied; skip `next()` to veto. */
-  'internal/update'(this: Fiber, config: any, noSave: boolean, next: () => void): void;
+  'internal/update'(this: Fiber, resolvedConfig: any, next: () => Awaitable<void>): Awaitable<void>;
+  /**
+   * Persist original config from a programmatic update, before its lifecycle transition.
+   * @param fiber - the updated fiber.
+   * @param originalConfig - the raw candidate; omitted when update uses noSave.
+   * @mode emit
+   */
+  'internal/commit'(fiber: Fiber, originalConfig: any): void;
+  /**
+   * Resolve plugin config after injections are active; candidate resolution does not publish it.
+   * @param fiber - the fiber whose candidate is being resolved.
+   * @param next - obtains the raw candidate from inner listeners.
+   * @mode waterfall
+   */
+  'internal/config'(fiber: Fiber, next: () => any): any;
   /** Waterfall: a service is being read through the context proxy. */
   'internal/get'(ctx: Context, name: string, error: Error, next: () => any): any;
   /** Waterfall: a service is being written through the context proxy. */
@@ -881,10 +906,10 @@ interface Events {
   /** Bail: a listener is being registered; a non-null result replaces registration. */
   'internal/listener'(this: Context, name: string, listener: any, prepend: boolean): void;
   /** An event is being dispatched to listeners (fired for non-internal events only). */
-  'internal/dispatch'(mode: DispatchMode, name: string, args: any[], thisArg: any): void;
+  'internal/dispatch'(mode: DispatchMode, name: string | symbol, args: any[], thisArg: any): void;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.0.5_@deepseek-ai+cordis-plugin-include@1.0.10_@deepseek-ai+cordis-plugin-loader@1.0.6/node_modules/@deepseek-ai/cordis/lib/types/logger.d.ts
+//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.1.0_@deepseek-ai+cordis-plugin-include@1.1.0_@deepseek-ai+cordis-plugin-loader@1.1.0/node_modules/@deepseek-ai/cordis/lib/types/logger.d.ts
 declare module './context.ts' {
   interface Intercept {
     logger: LoggerService.Intercept;
@@ -972,7 +997,7 @@ declare class LoggerService {
   [symbols.invoke](name?: string): Logger;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.0.5_@deepseek-ai+cordis-plugin-include@1.0.10_@deepseek-ai+cordis-plugin-loader@1.0.6/node_modules/@deepseek-ai/cordis/lib/types/context.d.ts
+//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.1.0_@deepseek-ai+cordis-plugin-include@1.1.0_@deepseek-ai+cordis-plugin-loader@1.1.0/node_modules/@deepseek-ai/cordis/lib/types/context.d.ts
 /**
  * Public shape of a Cordis context.
  *
@@ -988,7 +1013,7 @@ interface Context {
   /** The root context of the application (every child context shares it). @experimental */
   root: this;
   /** Base URL used to resolve relative plugin/module specifiers, if the runtime sets one. */
-  baseUrl?: string;
+  baseUrl?: string | undefined;
   /** The event bus. Its methods are also mixed onto `ctx` (`ctx.on`, `ctx.emit`, ...). */
   events: EventsService;
   /** The logging service. Call `ctx.logger(name)` for a named logger. */
@@ -1067,7 +1092,7 @@ declare class Context {
   intercept(name: string, config: any): this;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.0.5_@deepseek-ai+cordis-plugin-include@1.0.10_@deepseek-ai+cordis-plugin-loader@1.0.6/node_modules/@deepseek-ai/cordis/lib/types/service.d.ts
+//#region ../../node_modules/.pnpm/@deepseek-ai+cordis@4.1.0_@deepseek-ai+cordis-plugin-include@1.1.0_@deepseek-ai+cordis-plugin-loader@1.1.0/node_modules/@deepseek-ai/cordis/lib/types/service.d.ts
 /**
  * Base class for services that expose a named API on `ctx`.
  *
@@ -1122,6 +1147,13 @@ declare abstract class Service<out T = never> {
 }
 //#endregion
 //#region src/index.d.ts
-declare const apply: (ctx: Context) => () => Promise<void>;
+interface MaidLoggerConfig {
+  /** M3e §5:运行时缓存探针(默认 disabled——零监听零日志零 Session 写入)。 */
+  cacheProbe?: {
+    enabled?: boolean;
+    reportFile?: string;
+  };
+}
+declare const apply: (ctx: Context, config?: MaidLoggerConfig) => (() => Promise<void>);
 //#endregion
-export { apply };
+export { MaidLoggerConfig, apply };

package/lib/index.js

@@ -1,3 +1,50 @@
+import { createHash } from "node:crypto";
+//#region src/cache-probe.ts
+/** 签名 = sha256(systemText + tools 序列化);user/assistant 消息不参与。 */
+function defaultHash(input) {
+	return createHash("sha256").update(input).digest("hex").slice(0, 16);
+}
+/** 稳定序列化(键排序,数组保序)。 */
+function stableStringify(value) {
+	if (Array.isArray(value)) return `[${value.map(stableStringify).join(",")}]`;
+	if (typeof value === "object" && value !== null) return `{${Object.keys(value).sort().map((k) => `${JSON.stringify(k)}:${stableStringify(value[k])}`).join(",")}}`;
+	return JSON.stringify(value) ?? "null";
+}
+function createCacheProbe(options) {
+	const warn = options.warn ?? (() => {});
+	const hash = options.hash ?? defaultHash;
+	const report = options.reportSink ?? (() => {});
+	if (!options.enabled) return { observe: () => {} };
+	const lastSignature = /* @__PURE__ */ new Map();
+	let stopped = false;
+	return { observe(g) {
+		if (stopped) return;
+		const sessionId = g.sessionId;
+		if (sessionId === void 0 || sessionId === "") return;
+		if (g.purpose !== void 0) return;
+		try {
+			const systemText = (g.system ?? "") + (g.messages ?? []).filter((m) => m.role === "system").map((m) => typeof m.content === "string" ? m.content : stableStringify(m.content)).join("\n");
+			const signature = hash(`${systemText}\x00${stableStringify(g.tools ?? [])}`);
+			const prev = lastSignature.get(sessionId);
+			lastSignature.set(sessionId, signature);
+			if (prev !== void 0 && prev !== signature) {
+				const line = JSON.stringify({
+					ts: (/* @__PURE__ */ new Date()).toISOString(),
+					sessionId,
+					prev,
+					current: signature,
+					event: "cache-suspect"
+				});
+				warn(`maid-logger cache-probe: cache-suspect session=${sessionId} prev=${prev} current=${signature}`);
+				report(line);
+			}
+		} catch (error) {
+			stopped = true;
+			warn(`maid-logger cache-probe: 探针自停(签名计算异常:${error.message}),后续请求不再对账`);
+		}
+	} };
+}
+//#endregion
 //#region src/index.ts
 const TAG = {
 	error: "E",
@@ -14,7 +61,7 @@ const safeText = (a) => {
 		return String(a);
 	}
 };
-const apply = (ctx) => {
+const apply = (ctx, config) => {
 	ctx.logger.exporter({
 		levels: { default: 3 },
 		export(message) {
@@ -29,6 +76,18 @@ const apply = (ctx) => {
 			} catch {}
 		}
 	});
+	const probeConfig = config?.cacheProbe;
+	if (probeConfig?.enabled === true) {
+		const probe = createCacheProbe({
+			enabled: true,
+			warn: (m) => ctx.logger("maid-logger").warn(m),
+			...probeConfig.reportFile !== void 0 ? { reportFile: probeConfig.reportFile } : {}
+		});
+		ctx.on("llm/stream", ((options, next) => {
+			probe.observe(options);
+			return next();
+		}));
+	}
 	return async () => {};
 };
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepmaid/maid-logger",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "license": "MIT",
   "type": "module",
   "main": "lib/index.js",
@@ -28,7 +28,7 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/cordis": "4.1.0",
     "tsdown": "0.22.14",
     "typescript": "6.0.3"
   },