@sema-agent/core/dist/core/env-knob-announce.d.ts

Stateless, task-oriented AI agent core

/**
 * Say a knob-resolution fact once per process.
 *
 * Swallow-guarded, the same posture as every other advisory sink here (`deliverEngineNotice`,
 * `emitBrainStatus`, `emitBrainTelemetry`): an announcement must never become a failure. The write is
 * not to a channel this process owns — a host is free to replace `console.warn` with its own logger,
 * and a `Console` built with `ignoreErrors:false` throws on a full or closed stream. These resolvers
 * sit on hot paths that have already done irreversible work (the shell's output clip runs AFTER the
 * command ran), so an unguarded write could destroy a completed command's output and invite the caller
 * to run it again. The line is ledgered BEFORE delivery so a throwing sink cannot turn one fact into a
 * warning per call either.
 */
export declare function announceEnvKnob(line: string): void;
/** Test seam: the announcement de-dupes per process, so a test asserting the line must be able to clear
 *  the ledger. Never called by production code. */
export declare function __resetEnvKnobAnnouncements(): void;