agentfootprint/dist/strategies/defaults/consoleObservability.js

The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.

"use strict";
/**
 * `consoleObservability()` — default ObservabilityStrategy.
 *
 * Pattern: Strategy. Adapter for `globalThis.console`. Used when no
 *          vendor-specific strategy is configured (zero-config dev
 *          experience). Same role as `NoOpCacheStrategy` is for the
 *          cache layer.
 * Role:    Tier-1 fallback — print every event to the console with a
 *          one-line type+payload summary. Vendor-neutral, dependency-
 *          free, works in browser + Node + Deno + Bun.
 *
 * Use when:
 *   - Local development (`agent.enable.observability()` with no opts)
 *   - CI logs ("what events fired during this test?")
 *   - Tier-1 of compose chains (`compose([console(), datadog()])`)
 *
 * Don't use when: production. Console output is unstructured + can't
 * be queried; switch to a vendor strategy (Datadog, OTel, CloudWatch).
 */
Object.defineProperty(exports, "__esModule", { value: true });
exports.consoleObservability = void 0;
const wireJson_js_1 = require("../../lib/wireJson.js");
/**
 * Default formatter — emits a single structured JSON line per event.
 * Honeycomb / Datadog / Loki / any structured-log pipeline can ingest
 * directly; `grep` still works because every line is `{` … `}`.
 *
 * Shape: `{type, ...payload}` — flattens payload to top level so
 * filter expressions like `.type == "agentfootprint.cost.tick"` work
 * without nesting.
 */
const DEFAULT_FORMAT = (event) => {
    const payload = typeof event.payload === 'object' && event.payload !== null
        ? event.payload
        : { value: event.payload };
    return safeJson({ type: event.type, ...payload });
};
/**
 * Factory. Returns a fresh ObservabilityStrategy each call so multiple
 * agents in the same process get independent instances.
 */
function consoleObservability(opts = {}) {
    const sink = opts.logger ?? globalThis.console;
    const format = opts.format ?? DEFAULT_FORMAT;
    return {
        name: 'console',
        capabilities: { events: true, logs: true },
        exportEvent(event) {
            sink.log(format(event));
        },
    };
}
exports.consoleObservability = consoleObservability;
/** JSON.stringify with circular-safety. Avoids breaking the agent loop
 *  if a payload contains a circular ref. Returns the type alone if
 *  serialization fails. */
function safeJson(value) {
    try {
        return (0, wireJson_js_1.toWireJson)(value);
    }
    catch {
        return '[unserializable]';
    }
}
//# sourceMappingURL=consoleObservability.js.map