@senpi/runtime 3.0.6-dev.skill-manager-v2.20260629194505 → 3.0.9-dev.runtime-phase-2.20260707070820

package/dist/utils/event-catalog.js.map

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

package/dist/utils/logger.d.ts

@@ -1,6 +1,13 @@
 /**
  * Shared structured logger factory. Components create a logger with a namespace.
+ *
+ * Dual sink, one shape: every record renders to the TTY via `console.*` and is emitted
+ * as a real OTel LogRecord via the global Logs API. When the SDK is not initialised (off,
+ * or under test) the API resolves a no-op logger, so the emit is a near-zero no-op — no
+ * `enabled` gate needed. trace_id/span_id are stamped natively from the active span; the
+ * per-runtime `senpi.*` identity rides in via the async-context bag (see `trackingContext`).
  */
+import { type AttrsFor, type EventName } from "./event-catalog.js";
 export type LogLevel = "debug" | "info" | "warn" | "error";
 export type LogLevelSource = "config" | "env" | "default" | "runtime";
 /** Parse a candidate log-level string. Returns null for unknown values (caller decides how to warn/fallback). */
@@ -12,17 +19,68 @@ export interface ErrorNotificationPayload {
     namespace: string;
     level: "error";
     message: string;
-    meta?: unknown;
+    attributes?: unknown;
+    /**
+     * Normalized exception, present when the error call carried one. Built once alongside the
+     * log record's `exception.*` attributes so the notifier surfaces the same type/message/stack
+     * the log does — the raw error no longer rides in `attributes`.
+     */
+    exception?: NormalizedException;
     timestamp: string;
 }
 export type ErrorNotifier = (payload: ErrorNotificationPayload) => void | Promise<void>;
 export declare function setErrorNotifier(notifier: ErrorNotifier | null): void;
 export declare function clearErrorNotifier(): void;
+/** OTel exception semconv, normalized from any thrown value. Stacks are kept unredacted. */
+export interface NormalizedException {
+    type?: string;
+    message: string;
+    stacktrace?: string;
+}
+/**
+ * The options for an event emit. Placement is the control — there is no opt-out:
+ * - `body` — a deterministic, human/agent-readable narrative, templated from safe scalars. Safe by
+ *   construction, so it is NEVER redacted (and never capped — it is bounded by its template).
+ * - `attributes` — structured scalars, typed per event via {@link AttrsFor}. Safe by construction:
+ *   capped, but NEVER redacted.
+ * - `redact` — free-text / external strings (LLM reasoning, a venue error, a raw signal). The only
+ *   slot that is capped AND always run through redaction before it joins the emitted attributes.
+ * - `error` — a thrown value when this catalogued event IS also a fault (e.g. `order.failed` from a
+ *   venue throw). Normalized to `exception.*` semconv on the record (stack kept, uncapped) and recorded
+ *   on the active span, so one emit carries narrative + typed attrs + exception. Unlike `logger.error`,
+ *   it does NOT fan out the error notifier — severity is the call site's to grade via `level`.
+ */
+export interface EventOptions<N extends EventName> {
+    body: string;
+    attributes?: AttrsFor<N>;
+    redact?: Record<string, string>;
+    error?: unknown;
+}
 export interface Logger {
-    debug(message: string, meta?: unknown): void;
-    info(message: string, meta?: unknown): void;
-    warn(message: string, meta?: unknown): void;
-    error(message: string, meta?: unknown): void;
+    debug(message: string, attributes?: unknown): void;
+    info(message: string, attributes?: unknown): void;
+    /**
+     * @param error An `Error` (or other thrown value) → normalized to `exception.*` attributes and
+     *   recorded on the active span. Omit for a plain log; pass attributes here only when there is no
+     *   error (a non-`Error` value here is treated as the attributes bag for back-compat).
+     * @param attributes The attributes bag, when an error is also passed.
+     */
+    warn(message: string, error?: unknown, attributes?: unknown): void;
+    error(message: string, error?: unknown, attributes?: unknown): void;
+    /**
+     * Emit a first-class event from the closed {@link EventName} catalog: a deterministic narrative
+     * `body`, safe scalar `attributes` (typed per event, capped, never redacted), and optional
+     * free-text `redact` fields (capped + always scrubbed). The `name` is set as the OTel eventName,
+     * never sniffed from attributes. `level` drives severity (and the console sink). See
+     * {@link EventOptions}.
+     */
+    event<N extends EventName>(name: N, level: LogLevel, opts: EventOptions<N>): void;
 }
 export declare function createLogger(namespace: string): Logger;
+/**
+ * A complete {@link Logger} that discards everything. Use it as an explicit "be silent here" default
+ * (e.g. tests, or a consumer that doesn't wire logging) instead of hand-rolling a partial object —
+ * being defined alongside {@link Logger} it always satisfies the full contract as the interface grows.
+ */
+export declare const noopLogger: Logger;
 //# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAW3D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtE,iHAAiH;AACjH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAY7E;AAmBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAE,cAA0B,GAAG,IAAI,CAGrF;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,wBAAwB,KAC9B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAErE;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAMD,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9C;AAkBD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA8CtD"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,OAAO,EAEL,KAAK,QAAQ,EAEb,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAW3D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtE,iHAAiH;AACjH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAY7E;AAmBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAE,cAA0B,GAAG,IAAI,CAGrF;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,wBAAwB,KAC9B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAErE;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAgBD,4FAA4F;AAC5F,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA8HD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,SAAS;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClD;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACnE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACpE;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACnF;AAyJD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAsFtD;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,MAMxB,CAAC"}

package/dist/utils/logger.js

@@ -1,6 +1,19 @@
 /**
  * Shared structured logger factory. Components create a logger with a namespace.
+ *
+ * Dual sink, one shape: every record renders to the TTY via `console.*` and is emitted
+ * as a real OTel LogRecord via the global Logs API. When the SDK is not initialised (off,
+ * or under test) the API resolves a no-op logger, so the emit is a near-zero no-op — no
+ * `enabled` gate needed. trace_id/span_id are stamped natively from the active span; the
+ * per-runtime `senpi.*` identity rides in via the async-context bag (see `trackingContext`).
  */
+import { logs, SeverityNumber } from "@opentelemetry/api-logs";
+import { context, trace, SpanStatusCode } from "@opentelemetry/api";
+import { getTrackingContext } from "../telemetry/context.js";
+import { capValue, MAX_ATTR_VALUE_CHARS, MAX_BAG_KEYS, MAX_TOTAL_ATTR_CHARS, } from "../telemetry/attributes.js";
+import { getDefaultPiiRedactor } from "../telemetry/spans/redact-pii.js";
+import { appendDomainEvent } from "../telemetry/event-store.js";
+import { canonicalSeverity, } from "./event-catalog.js";
 const levelOrder = {
     debug: 0,
     info: 1,
@@ -55,6 +68,129 @@ export function clearErrorNotifier() {
 function shouldLog(level) {
     return levelOrder[level] >= levelOrder[minLevel];
 }
+/** Instrumentation scope for emitted LogRecords; matches the tracer name. */
+const LOGGER_SCOPE = "senpi-trading-runtime";
+const severityByLevel = {
+    debug: SeverityNumber.DEBUG,
+    info: SeverityNumber.INFO,
+    warn: SeverityNumber.WARN,
+    error: SeverityNumber.ERROR,
+};
+/** Normalize any thrown value to OTel exception semconv. Full type + message + stack for `Error`s. */
+function normalizeException(error) {
+    if (error instanceof Error) {
+        const normalized = { type: error.name, message: error.message };
+        if (error.stack)
+            normalized.stacktrace = error.stack;
+        return normalized;
+    }
+    return { message: String(error) };
+}
+/** The exception-semconv attribute keys for an emitted LogRecord. */
+function exceptionAttributes(exception) {
+    const attrs = { "exception.message": exception.message };
+    if (exception.type !== undefined)
+        attrs["exception.type"] = exception.type;
+    if (exception.stacktrace !== undefined)
+        attrs["exception.stacktrace"] = exception.stacktrace;
+    return attrs;
+}
+/**
+ * Safety net for raw `Error`s in the attributes bag: an `Error` is not a valid OTel attribute value,
+ * so it would be silently dropped. Strip every `Error` from the bag (keeping attributes valid) and
+ * surface the first one — for the legacy `{ err }` convention the caller passed no explicit error, so
+ * that first `Error` becomes the exception and the record is flagged (`code.error.scavenged`) to make
+ * the un-migrated site findable. Returns null when the bag holds no `Error`.
+ */
+function scavengeBagError(attributes) {
+    if (typeof attributes !== "object" || attributes === null || Array.isArray(attributes))
+        return null;
+    const entries = Object.entries(attributes);
+    const hit = entries.find(([, value]) => value instanceof Error);
+    if (hit === undefined)
+        return null;
+    const cleaned = {};
+    for (const [key, value] of entries) {
+        if (!(value instanceof Error))
+            cleaned[key] = value;
+    }
+    return { error: hit[1], cleaned };
+}
+/**
+ * Resolve the discriminated `(message, error?, attributes?)` arguments. The error slot collides with
+ * the legacy attributes-second convention, so we disambiguate at runtime: an explicit attributes arg
+ * (`arg3`) makes `arg2` the error; otherwise a plain object in `arg2` is the attributes bag
+ * (back-compat) and anything else — an `Error`, a thrown string/number, etc. — is the error. A thrown
+ * plain object (rare) is indistinguishable from a bag, so use the explicit three-arg form for it.
+ */
+function resolveErrorArgs(arg2, arg3) {
+    if (arg3 !== undefined)
+        return { error: arg2, attributes: arg3 };
+    if (typeof arg2 === "object" && arg2 !== null && !Array.isArray(arg2) && !(arg2 instanceof Error)) {
+        return { error: undefined, attributes: arg2 };
+    }
+    return { error: arg2, attributes: undefined };
+}
+/**
+ * Record the error on the active span: `recordException` for both warn and error so
+ * a swallowed-and-continuing failure still paints the waterfall (`withSpan` only records on rethrow);
+ * `setStatus(ERROR)` for `error` only — a `warn` is a handled failure and must not fail the span.
+ */
+function recordExceptionOnActiveSpan(error, level) {
+    try {
+        const span = trace.getActiveSpan();
+        if (span === undefined)
+            return;
+        span.recordException(error instanceof Error ? error : { message: String(error) });
+        if (level === "error") {
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    catch {
+        // A tracing failure must never disturb the logging caller.
+    }
+}
+/**
+ * Assemble LogRecord attributes: the component namespace, the caller's `attributes` (a plain
+ * object is the attributes bag — spread as-is; anything else is wrapped under `log.attributes`),
+ * any `extra` keys the warn/error path derived (exception semconv + the scavenger flag), and the
+ * current runtime's `senpi.*` identity from async-context (last, so it can't be clobbered). Identity
+ * is absent outside a runtime flow (e.g. process boot) — correct, not a gap.
+ */
+function buildLogAttributes(namespace, attributes, extra) {
+    const merged = { "code.namespace": namespace };
+    if (attributes !== undefined) {
+        if (typeof attributes === "object" && attributes !== null && !Array.isArray(attributes)) {
+            Object.assign(merged, attributes);
+        }
+        else {
+            merged["log.attributes"] = attributes;
+        }
+    }
+    if (extra !== undefined)
+        Object.assign(merged, extra);
+    const identity = getTrackingContext()?.identityAttributes;
+    if (identity)
+        Object.assign(merged, identity);
+    return merged;
+}
+/** Emit a structured LogRecord to the global Logs API. Guarded: telemetry never breaks the caller. */
+function emitLogRecord(namespace, level, message, attributes, extra) {
+    try {
+        logs.getLogger(LOGGER_SCOPE).emit({
+            severityNumber: severityByLevel[level],
+            severityText: level.toUpperCase(),
+            body: message,
+            attributes: buildLogAttributes(namespace, attributes, extra),
+        });
+    }
+    catch {
+        // A telemetry-side failure must never disturb the logging caller.
+    }
+}
 function dispatchErrorNotification(payload) {
     const notifier = errorNotifier;
     if (notifier == null || notifyingError)
@@ -72,59 +208,256 @@ function dispatchErrorNotification(payload) {
         }
     })();
 }
+/** Cap each redact-slot string at the per-value limit. Keys are pinned at the call site, so unbounded. */
+function capRedactFields(fields) {
+    const out = {};
+    for (const [key, value] of Object.entries(fields)) {
+        out[key] = capValue(value, MAX_ATTR_VALUE_CHARS);
+    }
+    return out;
+}
+/** Cap string scalar values at the per-value limit; numbers/booleans pass through. Not redacted. */
+function capScalars(attributes) {
+    if (attributes === undefined)
+        return undefined;
+    const out = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        out[key] = typeof value === "string" ? capValue(value, MAX_ATTR_VALUE_CHARS) : value;
+    }
+    return out;
+}
+/**
+ * Merge an event's redacted free-text fields and scalar attributes into one bag under a total-size +
+ * key-count budget (the same caps the recording row builder enforces, so one fat event can't blow
+ * past the OTLP body cap and drop the whole record). Scalars are added after the redact fields, so on
+ * a key collision the safe structured scalar wins over the free-text field — the redact slot is
+ * supplementary, not primary. Per-value capping already happened upstream. Runtime identity is
+ * layered on later in {@link buildLogAttributes} and stays authoritative.
+ */
+function mergeEventAttributes(attributes, redactFields) {
+    const merged = {};
+    let totalChars = 0;
+    let keyCount = 0;
+    const add = (key, value) => {
+        const cost = key.length + String(value).length;
+        if (keyCount >= MAX_BAG_KEYS || totalChars + cost > MAX_TOTAL_ATTR_CHARS)
+            return;
+        if (!(key in merged))
+            keyCount++;
+        merged[key] = value;
+        totalChars += cost;
+    };
+    if (redactFields !== undefined)
+        for (const [k, v] of Object.entries(redactFields))
+            add(k, v);
+    if (attributes !== undefined)
+        for (const [k, v] of Object.entries(attributes))
+            add(k, v);
+    return merged;
+}
+/**
+ * Emit one event LogRecord: the caller's safe scalar `attributes`, the (already capped) redacted
+ * free-text `redactFields`, `code.namespace`, runtime identity, and the catalog `name` as the OTel
+ * eventName. Severity is from `level`; the body is the narrative. `timestampMs` is the call-time
+ * stamp — passed explicitly so the redacted path (which emits a tick or more late) records the time
+ * the event happened, not the time redaction finished, keeping the log ordered by occurrence.
+ * `extra` carries exception semconv (`exception.*`) when the event also bore an error — layered in
+ * uncapped, like the warn/error path, so the stack survives the per-event size budget.
+ * Guarded — telemetry never disturbs the caller.
+ */
+function emitEventRecord(namespace, name, level, body, attributes, redactFields, timestampMs, extra) {
+    try {
+        const merged = buildLogAttributes(namespace, mergeEventAttributes(attributes, redactFields), extra);
+        logs.getLogger(LOGGER_SCOPE).emit({
+            timestamp: timestampMs,
+            severityNumber: severityByLevel[level],
+            severityText: level.toUpperCase(),
+            eventName: name,
+            body,
+            attributes: merged,
+        });
+    }
+    catch {
+        // A telemetry-side failure must never disturb the logging caller.
+    }
+}
+/**
+ * Redact the free-text fields (already capped) and emit, re-entering the captured trace context so
+ * the deferred LogRecord still carries the active span's `trace_id`/`span_id` and runtime identity.
+ * Redaction is intrinsically async (the redactor scans + awaits its mnemonic pre-pass), so this path
+ * cannot be made synchronous; the record carries the call-time `timestampMs`, so a consumer sorting
+ * by timestamp sees it in occurrence order regardless of how late redaction finishes. Fire-and-forget:
+ * the caller's `void` contract holds. Any failure — a thrown redactor, an emit error — is swallowed;
+ * an individual string whose redaction throws is dropped rather than emitted raw, so nothing
+ * unredacted reaches the wire on this path.
+ */
+function emitEventRedacted(redactor, captured, namespace, name, level, body, attributes, redactFields, timestampMs, extra) {
+    void (async () => {
+        try {
+            const redacted = {};
+            for (const [key, value] of Object.entries(redactFields)) {
+                try {
+                    redacted[key] = await redactor.redact(value);
+                }
+                catch {
+                    // Drop a value whose redaction threw rather than emit it unredacted.
+                }
+            }
+            context.with(captured, () => {
+                emitEventRecord(namespace, name, level, body, attributes, redacted, timestampMs, extra);
+            });
+        }
+        catch {
+            // The whole deferred path is fire-and-forget; no failure may surface as an
+            // unhandled rejection on the caller's process.
+        }
+    })();
+}
+/**
+ * Effective severity for an event: the catalogued canonical level is a FLOOR. A caller may escalate
+ * a catalogued event (e.g. an outcome that failed → `error`), but may never label it below its
+ * canonical severity (an `order.failed` stays `error` even if a caller passes `info`).
+ */
+function effectiveEventLevel(name, level) {
+    const canonical = canonicalSeverity(name);
+    return levelOrder[level] >= levelOrder[canonical] ? level : canonical;
+}
 export function createLogger(namespace) {
     return {
-        debug(message, meta) {
+        debug(message, attributes) {
             if (!shouldLog("debug"))
                 return;
             const prefix = `${namespace} [debug]`;
-            if (meta !== undefined) {
-                console.log(prefix, message, meta);
+            if (attributes !== undefined) {
+                console.log(prefix, message, attributes);
             }
             else {
                 console.log(prefix, message);
             }
+            emitLogRecord(namespace, "debug", message, attributes);
         },
-        info(message, meta) {
+        info(message, attributes) {
             if (!shouldLog("info"))
                 return;
             const prefix = `${namespace} [info]`;
-            if (meta !== undefined) {
-                console.log(prefix, message, meta);
+            if (attributes !== undefined) {
+                console.log(prefix, message, attributes);
             }
             else {
                 console.log(prefix, message);
             }
+            emitLogRecord(namespace, "info", message, attributes);
         },
-        warn(message, meta) {
+        warn(message, error, attributes) {
             if (!shouldLog("warn"))
                 return;
-            const prefix = `${namespace} [warn]`;
-            if (meta !== undefined) {
-                console.warn(prefix, message, meta);
-            }
-            else {
-                console.warn(prefix, message);
-            }
+            emitErrorAwareRecord(namespace, "warn", message, error, attributes);
         },
-        error(message, meta) {
+        error(message, error, attributes) {
             if (!shouldLog("error"))
                 return;
-            const prefix = `${namespace} [error]`;
-            if (meta !== undefined) {
-                console.error(prefix, message, meta);
+            emitErrorAwareRecord(namespace, "error", message, error, attributes);
+        },
+        event(name, level, opts) {
+            // The catalog severity is a floor — a caller may escalate but never demote a catalogued event.
+            const effectiveLevel = effectiveEventLevel(name, level);
+            // Stamp once, synchronously, so the redacted (deferred) path records when the event happened —
+            // not when redaction finished — and async redaction can never reorder the log.
+            const timestampMs = Date.now();
+            const { body, redact, error } = opts;
+            const attributes = capScalars(opts.attributes);
+            // Local sink: persist the capped scalars + body to the per-strategy on-disk ring so the agent
+            // can query the narrative without a collector. Fire-and-forget; never carries the redact slot.
+            appendDomainEvent(name, effectiveLevel, body, attributes, timestampMs);
+            // An error makes this catalogued event also a fault: stamp exception.* semconv (uncapped, via
+            // `extra`) and record it on the active span — synchronously here, so the deferred redacted path
+            // can't lose the call-time span. No notifier fan-out: severity is the caller's `level` to grade.
+            let exceptionExtra;
+            if (error !== undefined) {
+                exceptionExtra = exceptionAttributes(normalizeException(error));
+                recordExceptionOnActiveSpan(error, effectiveLevel);
+            }
+            // The event log is the trade narrative and must never go dark: the collector emit below and the
+            // local ring above are both unconditional. The narrative info/warn/error console logs (emitted
+            // at the call sites) carry docker stdout, so events no longer mirror to the console here.
+            const hasRedactFields = redact !== undefined && Object.keys(redact).length > 0;
+            if (!hasRedactFields) {
+                emitEventRecord(namespace, name, effectiveLevel, body, attributes, undefined, timestampMs, exceptionExtra);
+                return;
             }
-            else {
-                console.error(prefix, message);
+            const capped = capRedactFields(redact);
+            const redactor = getDefaultPiiRedactor();
+            // No redactor (boot window or tests): fail-safe — emit body + scalars, drop the redact fields
+            // rather than let an unredacted free-text value reach the wire.
+            if (redactor === null) {
+                emitEventRecord(namespace, name, effectiveLevel, body, attributes, undefined, timestampMs, exceptionExtra);
+                return;
             }
-            dispatchErrorNotification({
-                namespace,
-                level: "error",
-                message,
-                meta,
-                timestamp: new Date().toISOString(),
-            });
+            // Defer only this record behind the async redaction, re-entering the captured trace context.
+            // The call-time timestamp above keeps it ordered despite the deferral.
+            emitEventRedacted(redactor, context.active(), namespace, name, effectiveLevel, body, attributes, capped, timestampMs, exceptionExtra);
         },
     };
 }
+/**
+ * A complete {@link Logger} that discards everything. Use it as an explicit "be silent here" default
+ * (e.g. tests, or a consumer that doesn't wire logging) instead of hand-rolling a partial object —
+ * being defined alongside {@link Logger} it always satisfies the full contract as the interface grows.
+ */
+export const noopLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+    event: () => { },
+};
+/**
+ * Shared warn/error path: discriminate the error vs attributes args, scavenge any bag error, render
+ * the human line (with the error object, so the stack shows locally), emit the structured record
+ * with `exception.*` attributes, record on the active span, and — for `error` — fan out one
+ * normalized notification built from the same values.
+ */
+function emitErrorAwareRecord(namespace, level, message, arg2, arg3) {
+    let { error, attributes } = resolveErrorArgs(arg2, arg3);
+    let scavenged = false;
+    // Always strip raw Errors from the bag so they can't slip through as invalid OTel attributes;
+    // adopt the lifted one as the exception only when the caller passed no explicit error.
+    const found = scavengeBagError(attributes);
+    if (found !== null) {
+        attributes = found.cleaned;
+        if (error === undefined) {
+            error = found.error;
+            scavenged = true;
+        }
+    }
+    const exception = error !== undefined ? normalizeException(error) : undefined;
+    let extra;
+    if (exception !== undefined)
+        extra = exceptionAttributes(exception);
+    if (scavenged)
+        extra = { ...extra, "code.error.scavenged": true };
+    const prefix = `${namespace} [${level}]`;
+    const extras = [];
+    if (error !== undefined)
+        extras.push(error);
+    if (attributes !== undefined)
+        extras.push(attributes);
+    const sink = level === "warn" ? console.warn : console.error;
+    sink(prefix, message, ...extras);
+    emitLogRecord(namespace, level, message, attributes, extra);
+    if (error !== undefined)
+        recordExceptionOnActiveSpan(error, level);
+    if (level === "error") {
+        dispatchErrorNotification({
+            namespace,
+            level: "error",
+            message,
+            // The caller's bag without the error (which rides in `exception`) — not the `composed`
+            // bag, whose folded-in `exception.*` keys would duplicate the exception block.
+            attributes,
+            exception,
+            timestamp: new Date().toISOString(),
+        });
+    }
+}
 //# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/wallet-address.d.ts

@@ -0,0 +1,3 @@
+/** True when `address` is a path-safe wallet (`0x` + hex). Trims + lowercases before testing. */
+export declare function isWalletAddress(address: string): boolean;
+//# sourceMappingURL=wallet-address.d.ts.map

package/dist/utils/wallet-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-address.d.ts","sourceRoot":"","sources":["../../src/utils/wallet-address.ts"],"names":[],"mappings":"AAaA,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/utils/wallet-address.js

@@ -0,0 +1,17 @@
+/**
+ * Wallet-address path safety. The per-strategy event store and risk-audit log build on-disk paths
+ * from a caller-supplied wallet (`{stateDir}/strategies/{address}/…`), so a read RPC could otherwise
+ * smuggle `../../..` through and escape the strategy dir. This is the single shared guard the read
+ * paths route through before touching the filesystem.
+ *
+ * The check is `0x` + hex (case-insensitive, surrounding whitespace tolerated) — it rejects path
+ * separators, `..`, NUL, and any non-hex junk, which is what closes the traversal vector. It is
+ * deliberately NOT length-pinned to 40 hex chars: routing only needs path safety, and short fixtures
+ * stay valid.
+ */
+const WALLET_RE = /^0x[a-f0-9]+$/;
+/** True when `address` is a path-safe wallet (`0x` + hex). Trims + lowercases before testing. */
+export function isWalletAddress(address) {
+    return WALLET_RE.test(address.trim().toLowerCase());
+}
+//# sourceMappingURL=wallet-address.js.map

package/dist/utils/wallet-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-address.js","sourceRoot":"","sources":["../../src/utils/wallet-address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,SAAS,GAAG,eAAe,CAAC;AAElC,iGAAiG;AACjG,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACtD,CAAC"}