@framers/agentos 0.15.70 → 0.15.72

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

@@ -0,0 +1,349 @@
+/**
+ * @fileoverview AgentOS's events and context keys, declared once as data, and the checks a
+ * value passes before it reaches a line.
+ *
+ * Each event maps its fields to one of four kinds: `int` (an integer), `word` (letters,
+ * digits and `_ . : -`, at most 64 characters), `path` (a word that may also hold `/`, at
+ * most 128 characters) or an `enum` (one of a declared list). A word or a path with the shape
+ * of a credential is refused. Nothing a person wrote, a model answered or a tool was given is
+ * ever a field; a length or a count may be.
+ *
+ * @module agentos/core/logging/events
+ */
+/** The kind of one field: an integer, a word, a path, or one of a declared list. */
+export type FieldKind = 'int' | 'word' | 'path' | {
+    readonly enum: readonly string[];
+};
+/** A map from each event name to its fields and their kinds. */
+export type EventMap = Readonly<Record<string, Readonly<Record<string, FieldKind>>>>;
+/** The context keys a child may bind, and their kinds. */
+export type ContextSchema = Readonly<Record<string, FieldKind>>;
+/** The value type of one kind: a number for `int`, the listed strings for an `enum`, a string otherwise. */
+type Value<K extends FieldKind> = K extends 'int' ? number : K extends {
+    readonly enum: readonly (infer V)[];
+} ? V : string;
+/**
+ * The fields of one event, typed from its declaration. A declared field may be left out; a
+ * field that is not declared does not compile.
+ */
+export type Fields<S extends Readonly<Record<string, FieldKind>>> = {
+    [K in keyof S]?: Value<S[K]>;
+};
+/** The values a child may bind, typed from a context schema. */
+export type ContextValues<C extends ContextSchema> = Fields<C>;
+/** The provider names a line may carry. Any other provider is written as `unknown`. */
+export declare const PROVIDERS: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+/**
+ * The context keys a child may bind: `component` and `extension` as words, and `requestId`,
+ * which takes only letters, digits and dashes, at most 64 characters.
+ */
+export declare const AGENTOS_CONTEXT: {
+    readonly component: "word";
+    readonly extension: "word";
+    readonly requestId: "word";
+};
+/**
+ * Every event AgentOS writes, with its fields. A field that names a provider, a state or a
+ * reason is an `enum`, never a free word, and an error is written as its `type` and `code`.
+ */
+export declare const AGENTOS_EVENTS: {
+    readonly 'logging.level_unknown': {};
+    readonly 'agentos.untyped': {
+        readonly sourceLevel: {
+            readonly enum: readonly ["debug", "info", "warn", "error", "fatal"];
+        };
+    };
+    readonly console_line: {
+        readonly method: {
+            readonly enum: readonly ["debug", "info", "log", "warn", "error", "trace", "dir", "table", "assert", "count", "countReset", "time", "timeEnd", "timeLog", "group", "groupCollapsed", "groupEnd", "clear", "dirxml", "profile", "profileEnd", "timeStamp"];
+        };
+        readonly type: "word";
+        readonly code: "word";
+    };
+    readonly 'process.uncaught': {
+        readonly type: "word";
+        readonly code: "word";
+    };
+    readonly 'process.shutdown': {
+        readonly signal: {
+            readonly enum: readonly ["SIGTERM", "SIGINT"];
+        };
+    };
+    readonly 'http.request': {
+        readonly method: {
+            readonly enum: readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "CONNECT", "TRACE", "OTHER"];
+        };
+        readonly route: "path";
+        readonly status: "int";
+        readonly ms: "int";
+        readonly outcome: {
+            readonly enum: readonly ["ok", "aborted", "error"];
+        };
+    };
+    readonly 'http.handler_failed': {
+        readonly type: "word";
+        readonly code: "word";
+    };
+    readonly 'llm.provider_ready': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly count: "int";
+    };
+    readonly 'llm.provider_stopped': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+    };
+    readonly 'llm.provider_start_failed': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly type: "word";
+        readonly code: "word";
+    };
+    readonly 'llm.default_changed': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+    };
+    readonly 'llm.manager_state': {
+        readonly state: {
+            readonly enum: readonly ["reinitializing", "empty", "ready", "stopping", "stopped"];
+        };
+        readonly count: "int";
+    };
+    readonly 'llm.retry': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly status: "int";
+        readonly attempt: "int";
+        readonly waitMs: "int";
+    };
+    readonly 'llm.stream_invalid': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly bytes: "int";
+        readonly reason: {
+            readonly enum: readonly ["json", "shape", "framing", "mapping"];
+        };
+    };
+    readonly 'llm.stream_failed': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly type: "word";
+        readonly code: "word";
+    };
+    readonly 'llm.stream_cancel_failed': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly type: "word";
+        readonly code: "word";
+    };
+    readonly 'llm.models_refresh': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+    };
+    readonly 'llm.models_failed': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly type: "word";
+        readonly code: "word";
+    };
+    readonly 'llm.models_empty': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+    };
+    readonly 'llm.key_pool_out': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly count: "int";
+    };
+    readonly 'llm.option_ignored': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly reason: {
+            readonly enum: readonly ["provider_sort", "cache_retention", "embedding_capability"];
+        };
+    };
+    readonly 'llm.output_mismatch': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly reason: {
+            readonly enum: readonly ["tool_arguments", "text"];
+        };
+    };
+    readonly 'llm.output_empty': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly count: "int";
+    };
+    readonly 'llm.format_fallback': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly reason: {
+            readonly enum: readonly ["json_schema"];
+        };
+    };
+    readonly 'llm.response_format_failed': {
+        readonly provider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly type: "word";
+        readonly code: "word";
+    };
+    readonly 'llm.fallback_skipped': {
+        readonly reason: {
+            readonly enum: readonly ["duplicate", "excluded", "capability", "refusal", "refill", "unknown"];
+        };
+        readonly api: {
+            enum: readonly ["generateText", "streamText"];
+        };
+        readonly primaryProvider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly fallbackProvider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly attempt: "int";
+    };
+    readonly 'llm.fallback_circuit_open': {
+        readonly api: {
+            enum: readonly ["generateText", "streamText"];
+        };
+        readonly primaryProvider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly fallbackProvider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly attempt: "int";
+    };
+    readonly 'llm.fallback_fired': {
+        readonly type: "word";
+        readonly code: "word";
+        readonly api: {
+            enum: readonly ["generateText", "streamText"];
+        };
+        readonly primaryProvider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly fallbackProvider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly attempt: "int";
+    };
+    readonly 'llm.fallback_succeeded': {
+        readonly api: {
+            enum: readonly ["generateText", "streamText"];
+        };
+        readonly primaryProvider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly fallbackProvider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly attempt: "int";
+    };
+    readonly 'llm.fallback_failed_after_output': {
+        readonly api: {
+            enum: readonly ["generateText", "streamText"];
+        };
+        readonly primaryProvider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly fallbackProvider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly attempt: "int";
+    };
+    readonly 'llm.fallback_exhausted': {
+        readonly api: {
+            enum: readonly ["generateText", "streamText"];
+        };
+        readonly primaryProvider: {
+            enum: readonly ["openai", "openrouter", "anthropic", "gemini", "ollama", "requesty", "groq", "mistral", "together", "xai", "litellm", "minimax", "claude-code-cli", "gemini-cli", "unknown"];
+        };
+        readonly attempts: "int";
+        readonly type: "word";
+        readonly code: "word";
+    };
+};
+/** The type of {@link AGENTOS_EVENTS}, which `lazyLogger`'s handles are typed over. */
+export type AgentOSEvents = typeof AGENTOS_EVENTS;
+/** The values a child of an AgentOS handle may bind. */
+export type AgentOSContext = ContextValues<typeof AGENTOS_CONTEXT>;
+/**
+ * Whether a string has the shape of a credential. Segments are split at the start and end,
+ * `.`, `/`, `:`, `-` and whitespace, and the shapes are:
+ *
+ * - a key prefix (`sk-`, `sk_`, `pk_` or `rk_`) opening a segment;
+ * - the word `bearer`, in any case;
+ * - three base64url parts joined by dots (a JWT);
+ * - a whole segment of 20 or more letters, digits and underscores.
+ *
+ * @param value - The string to test.
+ * @returns `true` when the string must not reach a line.
+ */
+export declare function credential(value: string): boolean;
+/**
+ * Whether a value fits a field kind. A word or a path also fails when it has the shape of a
+ * credential, and the `requestId` context key takes only letters, digits and dashes. A word
+ * field named `type` also takes a class name ending in `Error` or `Exception`, and one named
+ * `code` an upper-case constant code such as `STREAM_PARSING_ERROR`, up to 64 characters and
+ * free of the other credential shapes, so that what {@link errorFields} writes passes.
+ *
+ * @param kind - The field's kind.
+ * @param value - The value, of any type, since JavaScript callers are checked too.
+ * @param key - The field's or the context key's name, which selects the `requestId`, `type` and `code` forms.
+ * @returns `true` when the value may be written.
+ */
+export declare function valid(kind: FieldKind, value: unknown, key?: string): boolean;
+/**
+ * A value as a word, or `unknown` when it is not a valid word.
+ *
+ * @param value - The value to write.
+ * @returns The value when it is a valid word, otherwise `'unknown'`.
+ */
+export declare function safeWord(value: unknown): string;
+/**
+ * The fields an error is written as: its type and its code, never its message or its stack.
+ * Either is `unknown` when it is not a valid word. A class name ending in `Error` or
+ * `Exception` and an upper-case constant code such as `STREAM_PARSING_ERROR` are kept at any
+ * length up to 64 characters, while a value with the shape of a credential is still `unknown`.
+ * Reading the error never throws: a property whose getter throws is written as `unknown`.
+ *
+ * @param error - The caught value.
+ * @returns `type`, the error's name (or the value's `typeof` when it is not an `Error`), and `code`, its `code` property.
+ *
+ * @example
+ * ```ts
+ * errorFields(Object.assign(new Error('text that is never written'), { code: 'ECONNRESET' }));
+ * // { type: 'Error', code: 'ECONNRESET' }
+ * ```
+ */
+export declare function errorFields(error: unknown): {
+    type: string;
+    code: string;
+};
+/**
+ * A provider's name as one of {@link PROVIDERS}, or `unknown`.
+ *
+ * @param value - The provider name to write.
+ * @returns The name when it is listed, otherwise `'unknown'`.
+ */
+export declare function providerName(value: unknown): (typeof PROVIDERS)[number];
+export {};
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/core/logging/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oFAAoF;AACpF,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvF,gEAAgE;AAChE,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAErF,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAEhE,4GAA4G;AAC5G,KAAK,KAAK,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,SAAS,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAA;CAAE,GAAG,CAAC,GAAG,MAAM,CAAC;AAE5H;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAErG,gEAAgE;AAChE,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,aAAa,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;AAE/D,uFAAuF;AACvF,eAAO,MAAM,SAAS,wLAAyL,CAAC;AAMhN;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;CAAuE,CAAC;AAEpG;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCE,CAAC;AAE9B,uFAAuF;AACvF,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC;AAElD,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC,OAAO,eAAe,CAAC,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD;AAcD;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,SAAK,GAAG,OAAO,CAQxE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAA+D;AAY/G;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAI1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAEvE"}

package/dist/core/logging/events.js

@@ -0,0 +1,164 @@
+/**
+ * @fileoverview AgentOS's events and context keys, declared once as data, and the checks a
+ * value passes before it reaches a line.
+ *
+ * Each event maps its fields to one of four kinds: `int` (an integer), `word` (letters,
+ * digits and `_ . : -`, at most 64 characters), `path` (a word that may also hold `/`, at
+ * most 128 characters) or an `enum` (one of a declared list). A word or a path with the shape
+ * of a credential is refused. Nothing a person wrote, a model answered or a tool was given is
+ * ever a field; a length or a count may be.
+ *
+ * @module agentos/core/logging/events
+ */
+/** The provider names a line may carry. Any other provider is written as `unknown`. */
+export const PROVIDERS = ['openai', 'openrouter', 'anthropic', 'gemini', 'ollama', 'requesty', 'groq', 'mistral', 'together', 'xai', 'litellm', 'minimax', 'claude-code-cli', 'gemini-cli', 'unknown'];
+const provider = { enum: PROVIDERS };
+const api = { enum: ['generateText', 'streamText'] };
+// The fields every fallback event of generateText and streamText shares.
+const fallback = { api, primaryProvider: provider, fallbackProvider: provider, attempt: 'int' };
+/**
+ * The context keys a child may bind: `component` and `extension` as words, and `requestId`,
+ * which takes only letters, digits and dashes, at most 64 characters.
+ */
+export const AGENTOS_CONTEXT = { component: 'word', extension: 'word', requestId: 'word' };
+/**
+ * Every event AgentOS writes, with its fields. A field that names a provider, a state or a
+ * reason is an `enum`, never a free word, and an error is written as its `type` and `code`.
+ */
+export const AGENTOS_EVENTS = {
+    'logging.level_unknown': {},
+    'agentos.untyped': { sourceLevel: { enum: ['debug', 'info', 'warn', 'error', 'fatal'] } },
+    'console_line': { method: { enum: ['debug', 'info', 'log', 'warn', 'error', 'trace', 'dir', 'table', 'assert', 'count', 'countReset', 'time', 'timeEnd', 'timeLog', 'group', 'groupCollapsed', 'groupEnd', 'clear', 'dirxml', 'profile', 'profileEnd', 'timeStamp'] }, type: 'word', code: 'word' },
+    'process.uncaught': { type: 'word', code: 'word' },
+    'process.shutdown': { signal: { enum: ['SIGTERM', 'SIGINT'] } },
+    'http.request': { method: { enum: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS', 'CONNECT', 'TRACE', 'OTHER'] }, route: 'path', status: 'int', ms: 'int', outcome: { enum: ['ok', 'aborted', 'error'] } },
+    'http.handler_failed': { type: 'word', code: 'word' },
+    'llm.provider_ready': { provider, count: 'int' },
+    'llm.provider_stopped': { provider },
+    'llm.provider_start_failed': { provider, type: 'word', code: 'word' },
+    'llm.default_changed': { provider },
+    'llm.manager_state': { state: { enum: ['reinitializing', 'empty', 'ready', 'stopping', 'stopped'] }, count: 'int' },
+    'llm.retry': { provider, status: 'int', attempt: 'int', waitMs: 'int' },
+    'llm.stream_invalid': { provider, bytes: 'int', reason: { enum: ['json', 'shape', 'framing', 'mapping'] } },
+    'llm.stream_failed': { provider, type: 'word', code: 'word' },
+    'llm.stream_cancel_failed': { provider, type: 'word', code: 'word' },
+    'llm.models_refresh': { provider },
+    'llm.models_failed': { provider, type: 'word', code: 'word' },
+    'llm.models_empty': { provider },
+    // Every key of a pool of several is out of rotation at start: the provider starts without its model listing.
+    'llm.key_pool_out': { provider, count: 'int' },
+    'llm.option_ignored': { provider, reason: { enum: ['provider_sort', 'cache_retention', 'embedding_capability'] } },
+    'llm.output_mismatch': { provider, reason: { enum: ['tool_arguments', 'text'] } },
+    'llm.output_empty': { provider, count: 'int' },
+    'llm.format_fallback': { provider, reason: { enum: ['json_schema'] } },
+    'llm.response_format_failed': { provider, type: 'word', code: 'word' },
+    'llm.fallback_skipped': { ...fallback, reason: { enum: ['duplicate', 'excluded', 'capability', 'refusal', 'refill', 'unknown'] } },
+    'llm.fallback_circuit_open': fallback,
+    'llm.fallback_fired': { ...fallback, type: 'word', code: 'word' },
+    'llm.fallback_succeeded': fallback,
+    'llm.fallback_failed_after_output': fallback,
+    'llm.fallback_exhausted': { api, primaryProvider: provider, attempts: 'int', type: 'word', code: 'word' },
+};
+/**
+ * Whether a string has the shape of a credential. Segments are split at the start and end,
+ * `.`, `/`, `:`, `-` and whitespace, and the shapes are:
+ *
+ * - a key prefix (`sk-`, `sk_`, `pk_` or `rk_`) opening a segment;
+ * - the word `bearer`, in any case;
+ * - three base64url parts joined by dots (a JWT);
+ * - a whole segment of 20 or more letters, digits and underscores.
+ *
+ * @param value - The string to test.
+ * @returns `true` when the string must not reach a line.
+ */
+export function credential(value) {
+    return keyShape(value) || /(?:^|[./:\s-])[A-Za-z0-9_]{20,}(?:$|[./:\s-])/.test(value);
+}
+// The credential shapes other than a long segment: a key prefix, the word bearer, or a JWT.
+function keyShape(value) {
+    return /(?:^|[./:\s-])(?:sk[-_]|pk_|rk_)/i.test(value) || /bearer/i.test(value)
+        || /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/.test(value);
+}
+// A class name ending in Error or Exception, and an upper-case constant code of two or more parts joined by
+// underscores, each part at most 16 characters. Either may be 20 characters or more, which the long-segment
+// credential rule alone would refuse; the other credential shapes still refuse them.
+const CLASS_NAME = /^[A-Z][A-Za-z0-9]{0,54}(?:Error|Exception)$/;
+const CONSTANT_CODE = /^[A-Z][A-Z0-9]{0,15}(?:_[A-Z0-9]{1,16})+$/;
+/**
+ * Whether a value fits a field kind. A word or a path also fails when it has the shape of a
+ * credential, and the `requestId` context key takes only letters, digits and dashes. A word
+ * field named `type` also takes a class name ending in `Error` or `Exception`, and one named
+ * `code` an upper-case constant code such as `STREAM_PARSING_ERROR`, up to 64 characters and
+ * free of the other credential shapes, so that what {@link errorFields} writes passes.
+ *
+ * @param kind - The field's kind.
+ * @param value - The value, of any type, since JavaScript callers are checked too.
+ * @param key - The field's or the context key's name, which selects the `requestId`, `type` and `code` forms.
+ * @returns `true` when the value may be written.
+ */
+export function valid(kind, value, key = '') {
+    if (kind === 'int')
+        return typeof value === 'number' && Number.isInteger(value);
+    if (typeof value !== 'string')
+        return false;
+    if (typeof kind === 'object')
+        return kind.enum.includes(value);
+    if (kind === 'word' && value.length <= 64 && ((key === 'type' && CLASS_NAME.test(value)) || (key === 'code' && CONSTANT_CODE.test(value))))
+        return !keyShape(value);
+    if (credential(value))
+        return false;
+    if (key === 'requestId')
+        return /^[A-Za-z0-9-]{1,64}$/.test(value);
+    return kind === 'path' ? /^[A-Za-z0-9_.:/-]{1,128}$/.test(value) : /^[A-Za-z0-9_.:-]{1,64}$/.test(value);
+}
+/**
+ * A value as a word, or `unknown` when it is not a valid word.
+ *
+ * @param value - The value to write.
+ * @returns The value when it is a valid word, otherwise `'unknown'`.
+ */
+export function safeWord(value) { return valid('word', value) ? value : 'unknown'; }
+// A value read from a caught error, or undefined when reading it throws.
+function read(get) {
+    try {
+        return get();
+    }
+    catch {
+        return undefined;
+    }
+}
+// A value as the word field named `key`, or `unknown` when it does not fit.
+function fieldWord(value, key) {
+    return valid('word', value, key) ? value : 'unknown';
+}
+/**
+ * The fields an error is written as: its type and its code, never its message or its stack.
+ * Either is `unknown` when it is not a valid word. A class name ending in `Error` or
+ * `Exception` and an upper-case constant code such as `STREAM_PARSING_ERROR` are kept at any
+ * length up to 64 characters, while a value with the shape of a credential is still `unknown`.
+ * Reading the error never throws: a property whose getter throws is written as `unknown`.
+ *
+ * @param error - The caught value.
+ * @returns `type`, the error's name (or the value's `typeof` when it is not an `Error`), and `code`, its `code` property.
+ *
+ * @example
+ * ```ts
+ * errorFields(Object.assign(new Error('text that is never written'), { code: 'ECONNRESET' }));
+ * // { type: 'Error', code: 'ECONNRESET' }
+ * ```
+ */
+export function errorFields(error) {
+    const type = read(() => (error instanceof Error ? error.name : typeof error));
+    const code = read(() => (typeof error === 'object' && error !== null ? error.code : undefined));
+    return { type: fieldWord(type, 'type'), code: fieldWord(code, 'code') };
+}
+/**
+ * A provider's name as one of {@link PROVIDERS}, or `unknown`.
+ *
+ * @param value - The provider name to write.
+ * @returns The name when it is listed, otherwise `'unknown'`.
+ */
+export function providerName(value) {
+    return PROVIDERS.includes(value) ? value : 'unknown';
+}
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/core/logging/events.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview Turns an event, its context and the current request's id into the call the
+ * current target takes, and keeps a failing sink away from the caller.
+ *
+ * A sink that throws never reaches the caller. A failed check is a `LogValidationError`:
+ * under `NODE_ENV=test` it is thrown, so a test that writes a bad field fails, and otherwise
+ * it becomes one `log_refused` line with a fixed reason and no key or value.
+ *
+ * @module agentos/core/logging/forward
+ */
+import type { Level } from './Logger.js';
+import type { Target } from './state.js';
+import { type ContextSchema, type EventMap } from './events.js';
+import { PinoLogger } from './PinoLogger.js';
+import { type ContentSafeLogComponent } from './contentSafeTelemetry.js';
+/** Why a line was refused. A refusal line carries the reason, never the key or the value. */
+export type RefusalReason = 'unknown_event' | 'unknown_key' | 'bad_value' | 'bad_context';
+declare const ERROR: unique symbol;
+/** A line that failed its event, field or context check. */
+export declare class LogValidationError extends Error {
+    readonly reason: RefusalReason;
+    readonly [ERROR] = true;
+    /** @param reason - Why the line was refused. */
+    constructor(reason: RefusalReason);
+}
+/**
+ * Whether a value is a {@link LogValidationError}, including one thrown by another copy of
+ * AgentOS in the process.
+ *
+ * @param error - The caught value.
+ * @returns `true` for a validation error from any copy of the package.
+ */
+export declare function isValidationError(error: unknown): error is LogValidationError;
+/**
+ * Runs one write to a sink and swallows what it throws, except a validation error under
+ * `NODE_ENV=test`, which reaches the test.
+ *
+ * @param write - The write to run.
+ */
+export declare function sinkCall(write: () => void): void;
+/**
+ * Checks bindings against a context schema.
+ *
+ * @param schema - The keys a child may bind, and their kinds.
+ * @param bindings - The bindings to check.
+ * @throws {LogValidationError} With `bad_context` when a key is not in the schema or its value breaks its kind.
+ */
+export declare function checkContext(schema: ContextSchema, bindings: Record<string, unknown>): void;
+/**
+ * Checks an event and its fields against an event map.
+ *
+ * @param events - The declared events.
+ * @param context - The context schema, whose keys a field cannot set.
+ * @param event - The event's name.
+ * @param fields - The event's fields.
+ * @throws {LogValidationError} With `unknown_event` for an undeclared event, `unknown_key` for an undeclared field or a context key, and `bad_value` for a value that breaks its kind.
+ */
+export declare function checkFields(events: EventMap, context: ContextSchema, event: string, fields: Record<string, unknown>): void;
+/**
+ * The default pino root, built on its first use at the level the environment names. When
+ * `AGENTOS_LOG_LEVEL` holds a value that is not a level name, the first build in the process
+ * writes one `logging.level_unknown` line, which never repeats the value.
+ *
+ * @returns The shared root.
+ */
+export declare function defaultRoot(): PinoLogger;
+/**
+ * Writes one line to a target.
+ *
+ * The line's context is the handle's bindings plus the current request's id. With `strict`
+ * the context, the event and its fields are checked against `AGENTOS_CONTEXT` and
+ * `AGENTOS_EVENTS`, the map a strict handle is typed over, so an event it does not declare,
+ * which only a JavaScript caller or a cast can write, is refused as `unknown_event`. A failed
+ * check is thrown under `NODE_ENV=test` and otherwise written as `log_refused`.
+ *
+ * A logger gets `logger[level]({ ...context, ...fields, event })`, with no message, and the
+ * default root writes the same object. A factory's logger gets `(event, fields)`: at `error`
+ * when it has no `fatal`, and not at all at `debug` when it has no `debug`. A silent target
+ * gets nothing. While content-safe telemetry is on, any other target gets nothing either: the
+ * line becomes one fixed event for the host's sink (a `fatal` line at `error`) naming `origin`,
+ * before any check, and nothing of it is read.
+ *
+ * @param target - Where the line goes.
+ * @param level - The line's level.
+ * @param event - The event's name.
+ * @param fields - The event's fields.
+ * @param context - The handle's bindings.
+ * @param strict - Whether to check the context and the fields; `createLogger`'s adapters pass `false`.
+ * @param origin - The fixed module word the content-safe event names; `library` for a handle no AgentOS module owns.
+ */
+export declare function forward(target: Target, level: Level, event: string, fields: Record<string, unknown>, context: Record<string, any>, strict?: boolean, origin?: ContentSafeLogComponent): void;
+export {};
+//# sourceMappingURL=forward.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forward.d.ts","sourceRoot":"","sources":["../../../src/core/logging/forward.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAA0C,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAsB,KAAK,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAE7F,6FAA6F;AAC7F,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,CAAC;AAE1F,QAAA,MAAM,KAAK,eAA8C,CAAC;AAE1D,4DAA4D;AAC5D,qBAAa,kBAAmB,SAAQ,KAAK;IAG/B,QAAQ,CAAC,MAAM,EAAE,aAAa;IAF1C,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ;IACxB,gDAAgD;gBAC3B,MAAM,EAAE,aAAa;CAC3C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAI3F;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAM1H;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,UAAU,CAWxC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,UAAO,EAAE,MAAM,GAAE,uBAAmC,GAAG,IAAI,CAyBpM"}