@framers/agentos 0.15.71 → 0.15.72

package/dist/core/logging/kit/processHandlers.js

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview Opt-in process handlers: the shutdown line and the process's last line.
+ *
+ * AgentOS never installs these. A host with handlers of its own calls the kit's `terminal()`
+ * from them instead.
+ *
+ * @module agentos/core/logging/kit/processHandlers
+ */
+import { errorFields } from '../events.js';
+import { getLoggingState } from '../state.js';
+/**
+ * Installs handlers for SIGTERM, SIGINT, uncaught exceptions and unhandled rejections.
+ *
+ * - On SIGTERM or SIGINT, the first signal writes `process.shutdown` with the signal, then
+ *   calls `onShutdown`, which owns closing the host's servers and pools and ending the
+ *   process. A later signal is ignored.
+ * - On an uncaught exception or an unhandled rejection, or when `onShutdown` fails, it writes
+ *   `process.uncaught` with the error's type and code through `terminal()`, which bypasses the
+ *   burst budget at `fatal`, then calls `onFatal`, which exits with status 1 unless the host
+ *   gives its own.
+ *
+ * Installing is idempotent across every copy of AgentOS in the process: while the handlers are
+ * installed, a second call returns the first call's remover and installs nothing.
+ *
+ * @param kit - The kit the lines are written through.
+ * @param options - The host's callbacks.
+ * @param options.onShutdown - Called once, after the shutdown line, with the signal.
+ * @param options.onFatal - Called after the last line with the error; `process.exit(1)` unless given.
+ * @returns A function that removes every handler it installed.
+ *
+ * @example
+ * ```ts
+ * installProcessHandlers(kit, { onShutdown: async () => { await server.close(); process.exit(0); } });
+ * ```
+ */
+export function installProcessHandlers(kit, options) {
+    const state = getLoggingState();
+    if (state.removeProcessHandlers)
+        return state.removeProcessHandlers;
+    let ending = false;
+    const fatal = (error) => {
+        try {
+            kit.terminal('process.uncaught', errorFields(error));
+        }
+        finally {
+            (options.onFatal ?? (() => process.exit(1)))(error);
+        }
+    };
+    const shutdown = (signal) => {
+        if (ending)
+            return;
+        ending = true;
+        try {
+            kit.info('process.shutdown', { signal });
+        }
+        finally {
+            Promise.resolve().then(() => options.onShutdown(signal)).catch(fatal);
+        }
+    };
+    const term = () => shutdown('SIGTERM');
+    const interrupt = () => shutdown('SIGINT');
+    process.on('SIGTERM', term);
+    process.on('SIGINT', interrupt);
+    process.on('uncaughtException', fatal);
+    process.on('unhandledRejection', fatal);
+    const remove = () => {
+        process.off('SIGTERM', term);
+        process.off('SIGINT', interrupt);
+        process.off('uncaughtException', fatal);
+        process.off('unhandledRejection', fatal);
+        if (state.removeProcessHandlers === remove)
+            state.removeProcessHandlers = undefined;
+    };
+    state.removeProcessHandlers = remove;
+    return remove;
+}
+//# sourceMappingURL=processHandlers.js.map

package/dist/core/logging/kit/processHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processHandlers.js","sourceRoot":"","sources":["../../../../src/core/logging/kit/processHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQ9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAe,EAAE,OAGvD;IACC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,qBAAqB;QAAE,OAAO,KAAK,CAAC,qBAAqB,CAAC;IACpE,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,EAAE;QAC/B,IAAI,CAAC;YAAC,GAAG,CAAC,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAAC,CAAC;gBACrD,CAAC;YAAC,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;IAClE,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,MAA4B,EAAE,EAAE;QAChD,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,GAAG,IAAI,CAAC;QACd,IAAI,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,CAAC;gBACzC,CAAC;YAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;IACpF,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAClF,IAAI,KAAK,CAAC,qBAAqB,KAAK,MAAM;YAAE,KAAK,CAAC,qBAAqB,GAAG,SAAS,CAAC;IACtF,CAAC,CAAC;IACF,KAAK,CAAC,qBAAqB,GAAG,MAAM,CAAC;IAAC,OAAO,MAAM,CAAC;AACtD,CAAC"}

package/dist/core/logging/level.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview The level of AgentOS's default logger, read from the environment.
+ *
+ * @module agentos/core/logging/level
+ */
+/** The level names pino takes, from the most verbose to the least, then `silent`. */
+declare const LEVELS: readonly ["trace", "debug", "info", "warn", "error", "fatal", "silent"];
+/**
+ * Reads the default logger's level from the environment.
+ *
+ * `AGENTOS_LOG_LEVEL` names the level, in any case. A value that is not a level name gives
+ * `info` with `unknown` set, and the caller writes one `logging.level_unknown` line, which
+ * never repeats the value. When `AGENTOS_LOG_LEVEL` is unset or names a level,
+ * `AGENTOS_DEBUG=1` or `AGENTOS_DEBUG=true` gives `debug`, as the providers' start-up checks
+ * read them. With neither set the level is `info`.
+ *
+ * @param env - The environment to read, usually `process.env`.
+ * @returns The level, and whether `AGENTOS_LOG_LEVEL` held a value that is not a level name.
+ *
+ * @example
+ * ```ts
+ * parseLogLevel({ AGENTOS_LOG_LEVEL: 'warn' }); // { level: 'warn', unknown: false }
+ * parseLogLevel({ AGENTOS_LOG_LEVEL: 'DEBUG' }); // { level: 'debug', unknown: false }
+ * parseLogLevel({ AGENTOS_LOG_LEVEL: 'loud' }); // { level: 'info', unknown: true }
+ * parseLogLevel({ AGENTOS_DEBUG: 'true' }); // { level: 'debug', unknown: false }
+ * ```
+ */
+export declare function parseLogLevel(env: Record<string, string | undefined>): {
+    level: (typeof LEVELS)[number];
+    unknown: boolean;
+};
+export {};
+//# sourceMappingURL=level.d.ts.map

package/dist/core/logging/level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level.d.ts","sourceRoot":"","sources":["../../../src/core/logging/level.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qFAAqF;AACrF,QAAA,MAAM,MAAM,yEAA0E,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG;IACtE,KAAK,EAAE,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;CAClD,CAKA"}

package/dist/core/logging/level.js

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview The level of AgentOS's default logger, read from the environment.
+ *
+ * @module agentos/core/logging/level
+ */
+/** The level names pino takes, from the most verbose to the least, then `silent`. */
+const LEVELS = ['trace', 'debug', 'info', 'warn', 'error', 'fatal', 'silent'];
+/**
+ * Reads the default logger's level from the environment.
+ *
+ * `AGENTOS_LOG_LEVEL` names the level, in any case. A value that is not a level name gives
+ * `info` with `unknown` set, and the caller writes one `logging.level_unknown` line, which
+ * never repeats the value. When `AGENTOS_LOG_LEVEL` is unset or names a level,
+ * `AGENTOS_DEBUG=1` or `AGENTOS_DEBUG=true` gives `debug`, as the providers' start-up checks
+ * read them. With neither set the level is `info`.
+ *
+ * @param env - The environment to read, usually `process.env`.
+ * @returns The level, and whether `AGENTOS_LOG_LEVEL` held a value that is not a level name.
+ *
+ * @example
+ * ```ts
+ * parseLogLevel({ AGENTOS_LOG_LEVEL: 'warn' }); // { level: 'warn', unknown: false }
+ * parseLogLevel({ AGENTOS_LOG_LEVEL: 'DEBUG' }); // { level: 'debug', unknown: false }
+ * parseLogLevel({ AGENTOS_LOG_LEVEL: 'loud' }); // { level: 'info', unknown: true }
+ * parseLogLevel({ AGENTOS_DEBUG: 'true' }); // { level: 'debug', unknown: false }
+ * ```
+ */
+export function parseLogLevel(env) {
+    const value = env.AGENTOS_LOG_LEVEL?.toLowerCase();
+    if (value && !LEVELS.includes(value))
+        return { level: 'info', unknown: true };
+    if (env.AGENTOS_DEBUG === '1' || env.AGENTOS_DEBUG === 'true')
+        return { level: 'debug', unknown: false };
+    return { level: (value || 'info'), unknown: false };
+}
+//# sourceMappingURL=level.js.map

package/dist/core/logging/level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"level.js","sourceRoot":"","sources":["../../../src/core/logging/level.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qFAAqF;AACrF,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,aAAa,CAAC,GAAuC;IAGnE,MAAM,KAAK,GAAG,GAAG,CAAC,iBAAiB,EAAE,WAAW,EAAE,CAAC;IACnD,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAgC,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACzG,IAAI,GAAG,CAAC,aAAa,KAAK,GAAG,IAAI,GAAG,CAAC,aAAa,KAAK,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACzG,OAAO,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,MAAM,CAA4B,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACjF,CAAC"}

package/dist/core/logging/loggerFactory.d.ts

@@ -1,31 +1,90 @@
 /**
- * @fileoverview The process-wide logger factory behind `createLogger`, and the guard that keeps every logger it
- * hands out, including one made before content-safe telemetry was enabled, inside that mode.
- * @module agentos/logging/loggerFactory
+ * @fileoverview How a host hands AgentOS its logger, the handles AgentOS writes through, and the
+ * guard that keeps every logger `createLogger` hands out inside content-safe telemetry.
+ *
+ * `setLogger` takes a pino-shaped logger, `setLoggerFactory` takes a factory of `ILogger`s,
+ * `setLogger(null)` silences AgentOS, and `resetLoggerFactory` returns to the default pino
+ * root, which is built on its first use. The last setter wins. `createLogger` calls the
+ * current factory at once and returns a guard over that factory's object: its calls reach the
+ * object until content-safe telemetry is enabled, and from then on each becomes one fixed
+ * event, even on a logger made earlier. `lazyLogger` returns a typed handle that reads the
+ * current target at each write, and so do its children; while content-safe telemetry is on,
+ * each of their lines is one fixed event as well.
+ *
+ * @module agentos/core/logging/loggerFactory
  */
 import type { ILogger } from './ILogger.js';
+import type { Logger, EventLogger } from './Logger.js';
+import type { AgentOSEvents, AgentOSContext } from './events.js';
+import { type LoggerFactory } from './state.js';
+import { type ContentSafeLogComponent } from './contentSafeTelemetry.js';
+export type { LoggerFactory } from './state.js';
 /**
- * Makes the logger `createLogger` delegates to, from a component name and optional bindings.
+ * Hands AgentOS a pino-shaped logger, or silences it with `null`. Lazy handles, whenever they
+ * were made, write to it from their next line; an object `createLogger` returned earlier keeps
+ * its target.
+ *
+ * @param logger - A logger with `debug`, `info`, `warn`, `error`, `fatal` and `child`, such as a pino logger or a pino child, or `null` to write nothing.
+ * @throws {TypeError} When one of those methods is missing, naming it.
+ *
+ * @example
+ * ```ts
+ * import pino from 'pino';
+ * setLogger(pino());
+ * ```
  */
-export type LoggerFactory = (name: string, bindings?: Record<string, any>) => ILogger;
+export declare function setLogger(logger: Logger | null): void;
 /**
- * Sets the factory that later `createLogger` calls delegate to.
+ * Hands AgentOS a factory of `ILogger`s. `createLogger` calls it at once. A lazy handle calls
+ * it at each write with its component and context, and writes `(event, fields)` to the logger
+ * it returns.
  *
- * @param factory - Makes the logger for a component name and optional bindings.
+ * @param factory - The factory.
  */
 export declare function setLoggerFactory(factory: LoggerFactory): void;
-/**
- * Restores the default factory: children of a new root `PinoLogger` named `agentos`.
- */
+/** Returns AgentOS to its default pino root, which is built again on its next use. */
 export declare function resetLoggerFactory(): void;
 /**
- * A logger for one component. Its calls go to the logger the current factory makes, with the caller's arguments,
- * until content-safe telemetry is enabled; from then on each call becomes one fixed event for the host's sink, even
- * on a logger created earlier. While the mode is on, the factory is not called and `child` returns the same logger.
+ * Returns a component's logger: a guard over the logger the current target gives. With a factory
+ * set, it calls the factory at once; otherwise it takes a child of the default root, or an
+ * adapter over the logger or the silence set now, and that logger keeps its target after a later
+ * setter. The guard's calls reach that logger, with the caller's arguments, until content-safe
+ * telemetry is enabled; from then on each call becomes one fixed event for the host's sink, even
+ * on a logger made earlier, and `child` returns the same logger. While the mode is on, the
+ * factory is not called and nothing is made.
  *
- * @param name - The component name.
- * @param bindings - Fields every record of the logger carries.
+ * @param name - The component's name.
+ * @param bindings - Bindings for every line the logger writes.
  * @returns The component's logger.
  */
 export declare function createLogger(name: string, bindings?: Record<string, any>): ILogger;
+/**
+ * Returns a typed handle that reads the current target at each write, so a handle made at
+ * import follows a later `setLogger` or `setLoggerFactory`; its children do the same. Its
+ * methods take only an event `AGENTOS_EVENTS` declares, with that event's fields.
+ *
+ * @param component - The component the lines come from.
+ * @param context - More context keys to bind, such as `extension`.
+ * @returns The handle.
+ * @throws {LogValidationError} Under `NODE_ENV=test`, when the component or the context breaks AgentOS's context schema; otherwise such a handle writes one `log_refused` line and then nothing.
+ *
+ * @example
+ * ```ts
+ * const log = lazyLogger('OpenAIProvider');
+ * log.warn('llm.retry', { provider: 'openai', status: 429, attempt: 1, waitMs: 2000 });
+ * ```
+ */
+export declare function lazyLogger(component: string, context?: AgentOSContext): EventLogger<AgentOSEvents>;
+/**
+ * The handle an AgentOS module writes through: a {@link lazyLogger} handle whose lines, while
+ * content-safe telemetry is on, each reach the sink as one fixed event naming the module, as
+ * the module's console lines do. An origin outside `CONTENT_SAFE_COMPONENTS` reads as
+ * `library`.
+ *
+ * @param component - The component the lines come from.
+ * @param origin - The module's fixed word in `CONTENT_SAFE_COMPONENTS`.
+ * @returns The handle.
+ * @internal
+ */
+export declare function moduleLogger(component: string, origin: ContentSafeLogComponent): EventLogger<AgentOSEvents>;
 //# sourceMappingURL=loggerFactory.d.ts.map

package/dist/core/logging/loggerFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loggerFactory.d.ts","sourceRoot":"","sources":["../../../src/core/logging/loggerFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;AA+BtF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAA8B;AAE5F;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAGlF"}
+{"version":3,"file":"loggerFactory.d.ts","sourceRoot":"","sources":["../../../src/core/logging/loggerFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAS,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAmB,KAAK,aAAa,EAAe,MAAM,YAAY,CAAC;AAE9E,OAAO,EAAqD,KAAK,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC5H,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAOrD;AAkCD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAA6D;AAE3H,sFAAsF;AACtF,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AA4BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAMlF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,WAAW,CAAC,aAAa,CAAC,CAEtG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,WAAW,CAAC,aAAa,CAAC,CAE3G"}

package/dist/core/logging/loggerFactory.js

@@ -1,10 +1,49 @@
-import { PinoLogger } from './PinoLogger.js';
+/**
+ * @fileoverview How a host hands AgentOS its logger, the handles AgentOS writes through, and the
+ * guard that keeps every logger `createLogger` hands out inside content-safe telemetry.
+ *
+ * `setLogger` takes a pino-shaped logger, `setLoggerFactory` takes a factory of `ILogger`s,
+ * `setLogger(null)` silences AgentOS, and `resetLoggerFactory` returns to the default pino
+ * root, which is built on its first use. The last setter wins. `createLogger` calls the
+ * current factory at once and returns a guard over that factory's object: its calls reach the
+ * object until content-safe telemetry is enabled, and from then on each becomes one fixed
+ * event, even on a logger made earlier. `lazyLogger` returns a typed handle that reads the
+ * current target at each write, and so do its children; while content-safe telemetry is on,
+ * each of their lines is one fixed event as well.
+ *
+ * @module agentos/core/logging/loggerFactory
+ */
+import { AGENTOS_CONTEXT } from './events.js';
+import { getLoggingState } from './state.js';
+import { checkContext, defaultRoot, forward, isValidationError } from './forward.js';
 import { emitContentSafeLog, isContentSafeTelemetryEnabled } from './contentSafeTelemetry.js';
-let rootLogger = new PinoLogger({ name: 'agentos' });
-let currentFactory = (name, bindings) => rootLogger.child({ component: name, ...(bindings || {}) });
+/**
+ * Hands AgentOS a pino-shaped logger, or silences it with `null`. Lazy handles, whenever they
+ * were made, write to it from their next line; an object `createLogger` returned earlier keeps
+ * its target.
+ *
+ * @param logger - A logger with `debug`, `info`, `warn`, `error`, `fatal` and `child`, such as a pino logger or a pino child, or `null` to write nothing.
+ * @throws {TypeError} When one of those methods is missing, naming it.
+ *
+ * @example
+ * ```ts
+ * import pino from 'pino';
+ * setLogger(pino());
+ * ```
+ */
+export function setLogger(logger) {
+    if (logger !== null) {
+        for (const name of ['debug', 'info', 'warn', 'error', 'fatal', 'child']) {
+            if (typeof logger?.[name] !== 'function')
+                throw new TypeError(`Logger.${name} must be a function`);
+        }
+    }
+    getLoggingState().target = logger === null ? { mode: 'silent' } : { mode: 'logger', logger };
+}
 /**
  * Wraps `raw` so each call is checked against content-safe telemetry when it is made. While the mode is off, a call
- * goes to `raw` with the caller's own arguments; while it is on, it becomes one fixed event and `raw` is not called.
+ * goes to `raw` with the caller's own arguments, a `fatal` call to `raw.error` when `raw` has no `fatal`; while it is
+ * on, it becomes one fixed event and `raw` is not called.
  */
 function guarded(raw) {
     const logger = {
@@ -24,6 +63,14 @@ function guarded(raw) {
             if (!emitContentSafeLog('debug', 'logger_factory'))
                 raw?.debug?.(...args);
         },
+        fatal(...args) {
+            if (emitContentSafeLog('error', 'logger_factory'))
+                return;
+            if (raw?.fatal)
+                raw.fatal(...args);
+            else
+                raw?.error(...args);
+        },
         child(bindings) {
             if (isContentSafeTelemetryEnabled())
                 return logger;
@@ -33,30 +80,103 @@ function guarded(raw) {
     return logger;
 }
 /**
- * Sets the factory that later `createLogger` calls delegate to.
+ * Hands AgentOS a factory of `ILogger`s. `createLogger` calls it at once. A lazy handle calls
+ * it at each write with its component and context, and writes `(event, fields)` to the logger
+ * it returns.
  *
- * @param factory - Makes the logger for a component name and optional bindings.
- */
-export function setLoggerFactory(factory) { currentFactory = factory; }
-/**
- * Restores the default factory: children of a new root `PinoLogger` named `agentos`.
+ * @param factory - The factory.
  */
+export function setLoggerFactory(factory) { getLoggingState().target = { mode: 'factory', factory }; }
+/** Returns AgentOS to its default pino root, which is built again on its next use. */
 export function resetLoggerFactory() {
-    rootLogger = new PinoLogger({ name: 'agentos' });
-    currentFactory = (name, bindings) => rootLogger.child({ component: name, ...(bindings || {}) });
+    const state = getLoggingState();
+    state.target = { mode: 'default' };
+    state.root = undefined;
+}
+// An ILogger over the target `target()` returns at each write. A child merges its bindings onto its parent's. With
+// `strict` they are checked against AgentOS's context schema before the child is made: a child whose bindings fail
+// writes one `log_refused` line and then nothing, and under NODE_ENV=test the failure is thrown instead. While
+// content-safe telemetry is on, each line, a child's included, is one fixed event naming `origin`.
+function adapter(target, bindings, strict, disabled = false, origin = 'library') {
+    const write = (level) => (event, fields = {}) => {
+        if (!disabled)
+            forward(target(), level, event, fields, bindings, strict, origin);
+    };
+    return {
+        debug: write('debug'), info: write('info'), warn: write('warn'), error: write('error'), fatal: write('fatal'),
+        child(child) {
+            const merged = { ...bindings, ...child };
+            if (strict) {
+                try {
+                    checkContext(AGENTOS_CONTEXT, merged);
+                }
+                catch (error) {
+                    if (!isValidationError(error))
+                        throw error;
+                    if (process.env.NODE_ENV === 'test')
+                        throw error;
+                    forward(target(), 'warn', 'log_refused', { reason: 'bad_context' }, {}, false, origin);
+                    return adapter(target, {}, strict, true, origin);
+                }
+            }
+            return adapter(target, merged, strict, disabled, origin);
+        },
+    };
 }
 /**
- * A logger for one component. Its calls go to the logger the current factory makes, with the caller's arguments,
- * until content-safe telemetry is enabled; from then on each call becomes one fixed event for the host's sink, even
- * on a logger created earlier. While the mode is on, the factory is not called and `child` returns the same logger.
+ * Returns a component's logger: a guard over the logger the current target gives. With a factory
+ * set, it calls the factory at once; otherwise it takes a child of the default root, or an
+ * adapter over the logger or the silence set now, and that logger keeps its target after a later
+ * setter. The guard's calls reach that logger, with the caller's arguments, until content-safe
+ * telemetry is enabled; from then on each call becomes one fixed event for the host's sink, even
+ * on a logger made earlier, and `child` returns the same logger. While the mode is on, the
+ * factory is not called and nothing is made.
  *
- * @param name - The component name.
- * @param bindings - Fields every record of the logger carries.
+ * @param name - The component's name.
+ * @param bindings - Bindings for every line the logger writes.
  * @returns The component's logger.
  */
 export function createLogger(name, bindings) {
     if (isContentSafeTelemetryEnabled())
         return guarded();
-    return guarded(currentFactory(name, bindings));
+    const target = getLoggingState().target;
+    if (target.mode === 'factory')
+        return guarded(target.factory(name, bindings));
+    if (target.mode === 'default')
+        return guarded(defaultRoot().child({ component: name, ...bindings }));
+    return guarded(adapter(() => target, { component: name, ...bindings }, false));
+}
+/**
+ * Returns a typed handle that reads the current target at each write, so a handle made at
+ * import follows a later `setLogger` or `setLoggerFactory`; its children do the same. Its
+ * methods take only an event `AGENTOS_EVENTS` declares, with that event's fields.
+ *
+ * @param component - The component the lines come from.
+ * @param context - More context keys to bind, such as `extension`.
+ * @returns The handle.
+ * @throws {LogValidationError} Under `NODE_ENV=test`, when the component or the context breaks AgentOS's context schema; otherwise such a handle writes one `log_refused` line and then nothing.
+ *
+ * @example
+ * ```ts
+ * const log = lazyLogger('OpenAIProvider');
+ * log.warn('llm.retry', { provider: 'openai', status: 429, attempt: 1, waitMs: 2000 });
+ * ```
+ */
+export function lazyLogger(component, context = {}) {
+    return adapter(() => getLoggingState().target, {}, true).child({ component, ...context });
+}
+/**
+ * The handle an AgentOS module writes through: a {@link lazyLogger} handle whose lines, while
+ * content-safe telemetry is on, each reach the sink as one fixed event naming the module, as
+ * the module's console lines do. An origin outside `CONTENT_SAFE_COMPONENTS` reads as
+ * `library`.
+ *
+ * @param component - The component the lines come from.
+ * @param origin - The module's fixed word in `CONTENT_SAFE_COMPONENTS`.
+ * @returns The handle.
+ * @internal
+ */
+export function moduleLogger(component, origin) {
+    return adapter(() => getLoggingState().target, {}, true, false, origin).child({ component });
 }
 //# sourceMappingURL=loggerFactory.js.map

package/dist/core/logging/loggerFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"loggerFactory.js","sourceRoot":"","sources":["../../../src/core/logging/loggerFactory.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAM9F,IAAI,UAAU,GAAG,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AACrD,IAAI,cAAc,GAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CACrD,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAE7D;;;GAGG;AACH,SAAS,OAAO,CAAC,GAAa;IAC5B,MAAM,MAAM,GAAY;QACtB,IAAI,CAAC,GAAG,IAAiC;YACvC,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAAE,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,GAAG,IAAiC;YACvC,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAAE,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACxE,CAAC;QACD,KAAK,CAAC,GAAG,IAAkC;YACzC,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAAE,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1E,CAAC;QACD,KAAK,CAAC,GAAG,IAA+C;YACtD,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAAE,GAAG,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,CAAC,QAAQ;YACZ,IAAI,6BAA6B,EAAE;gBAAE,OAAO,MAAM,CAAC;YACnD,OAAO,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB,IAAU,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;AAE5F;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,UAAU,GAAG,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACjD,cAAc,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAClG,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAA8B;IACvE,IAAI,6BAA6B,EAAE;QAAE,OAAO,OAAO,EAAE,CAAC;IACtD,OAAO,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"loggerFactory.js","sourceRoot":"","sources":["../../../src/core/logging/loggerFactory.ts"],"names":[],"mappings":"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"}

package/dist/core/logging/state.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview The one logging state every copy of AgentOS in a process shares.
+ *
+ * The state lives on `globalThis` under `Symbol.for('agentos.logging.state.v1')`, so a
+ * product and a pack's nested install of AgentOS obey one hand-over. The `v1` in the key
+ * changes only when the state's shape does.
+ *
+ * @module agentos/core/logging/state
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import type { ILogger } from './ILogger.js';
+import type { Logger } from './Logger.js';
+import type { PinoLogger } from './PinoLogger.js';
+/** A host's factory: called with a component's name and its bindings, it returns that component's logger. */
+export type LoggerFactory = (name: string, bindings?: Record<string, any>) => ILogger;
+/**
+ * Where AgentOS's lines go: the lazy default root, a logger from `setLogger`, a factory from
+ * `setLoggerFactory`, or nowhere after `setLogger(null)`.
+ */
+export type Target = {
+    mode: 'default';
+} | {
+    mode: 'silent';
+} | {
+    mode: 'logger';
+    logger: Logger;
+} | {
+    mode: 'factory';
+    factory: LoggerFactory;
+};
+/**
+ * One burst budget for the current minute, kept for an event or a refusal reason and shared by
+ * every kit instance in the process.
+ */
+export interface Minute {
+    /** When the minute began, in milliseconds since the epoch. */
+    start: number;
+    /** Lines written in this minute. */
+    written: number;
+    /** Lines held back in this minute, reported in one line when the minute ends. */
+    held: number;
+    /** The smallest bound any kit asked for in this minute. */
+    limit: number;
+    /** The kit that opened the budget, whose writer reports the held lines. */
+    owner: symbol;
+    /** The event or the refusal reason the held-lines report names. */
+    name: string;
+}
+/** The process-wide logging state. */
+export interface LoggingState {
+    /** Where lines go now. The last setter wins. */
+    target: Target;
+    /** The default pino root, built on its first use and dropped by `resetLoggerFactory`. */
+    root?: PinoLogger;
+    /** Whether the line about an unknown `AGENTOS_LOG_LEVEL` has been written; it is written once. */
+    levelWarned: boolean;
+    /** The current request's id, which the forwarding layer adds to each line's context. */
+    requests: AsyncLocalStorage<{
+        requestId: string;
+    }>;
+    /** The burst budgets of the current minute, by key. */
+    minutes: Map<string, Minute>;
+    /** Each open kit's writer for its held-lines reports. */
+    owners: Map<symbol, (name: string, n: number) => void>;
+    /** The unreferenced timer that reports held lines when a minute ends. */
+    timer?: ReturnType<typeof setTimeout>;
+    /** Removes the installed process handlers, when a kit has installed them. */
+    removeProcessHandlers?: () => void;
+}
+/**
+ * The process's logging state, created on the first call. Every copy of AgentOS in the
+ * process reads the same object.
+ *
+ * @returns The shared state.
+ */
+export declare function getLoggingState(): LoggingState;
+//# sourceMappingURL=state.d.ts.map

package/dist/core/logging/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/core/logging/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,6GAA6G;AAC7G,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;AAEtF;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC;AAEjJ;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,kGAAkG;IAClG,WAAW,EAAE,OAAO,CAAC;IACrB,wFAAwF;IACxF,QAAQ,EAAE,iBAAiB,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,uDAAuD;IACvD,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,yDAAyD;IACzD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC;IACvD,yEAAyE;IACzE,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACtC,6EAA6E;IAC7E,qBAAqB,CAAC,EAAE,MAAM,IAAI,CAAC;CACpC;AAGD;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAM9C"}

package/dist/core/logging/state.js

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview The one logging state every copy of AgentOS in a process shares.
+ *
+ * The state lives on `globalThis` under `Symbol.for('agentos.logging.state.v1')`, so a
+ * product and a pack's nested install of AgentOS obey one hand-over. The `v1` in the key
+ * changes only when the state's shape does.
+ *
+ * @module agentos/core/logging/state
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+const KEY = Symbol.for('agentos.logging.state.v1');
+/**
+ * The process's logging state, created on the first call. Every copy of AgentOS in the
+ * process reads the same object.
+ *
+ * @returns The shared state.
+ */
+export function getLoggingState() {
+    const holder = globalThis;
+    return holder[KEY] ?? (holder[KEY] = {
+        target: { mode: 'default' }, levelWarned: false,
+        requests: new AsyncLocalStorage(), minutes: new Map(), owners: new Map(),
+    });
+}
+//# sourceMappingURL=state.js.map

package/dist/core/logging/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/core/logging/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAoDrD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,UAAiE,CAAC;IACjF,OAAO,MAAM,CAAC,GAAG,MAAV,MAAM,CAAC,GAAG,IAAM;QACrB,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,KAAK;QAC/C,QAAQ,EAAE,IAAI,iBAAiB,EAAE,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE;KACzE,EAAC;AACJ,CAAC"}

package/dist/core/utils/terminal.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview The one module allowed to write the standard streams directly.
+ *
+ * AgentOS's lines go through the logging hand-over; text meant for a person at a terminal, such
+ * as an interactive prompt or the frames-only stack the allow-list kit's console capture
+ * prints, goes through {@link terminal}.
+ *
+ * @module agentos/core/utils/terminal
+ */
+/**
+ * Writes text to standard output or standard error. A failing stream never reaches the caller.
+ *
+ * @param text - The text to write, as it should appear, with its own line ending.
+ * @param stream - The stream to write to, `stdout` unless given.
+ *
+ * @example
+ * ```ts
+ * terminal('Continue? [y/N] ');
+ * ```
+ */
+export declare function terminal(text: string, stream?: 'stdout' | 'stderr'): void;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/core/utils/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../src/core/utils/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,QAAQ,GAAG,QAAmB,GAAG,IAAI,CAEnF"}