agentfootprint/dist/injection-engine/factories/defineSteering.js

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

"use strict";
/**
 * defineSteering — sugar for always-on system-prompt Injections.
 *
 * Steering docs are the simplest form of context engineering: a fixed
 * piece of guidance the LLM should follow on every iteration. Style
 * guides, output format rules, persona statements, safety policies.
 *
 * Produces an `Injection` with:
 *   - flavor: `'steering'`
 *   - trigger: `{ kind: 'always' }`
 *   - inject: `{ systemPrompt: prompt }`
 *
 * @example
 *   const jsonOnly = defineSteering({
 *     id: 'json-only',
 *     description: 'Always respond with valid JSON.',
 *     prompt: 'Respond with JSON only. No prose. No markdown.',
 *   });
 */
Object.defineProperty(exports, "__esModule", { value: true });
exports.defineSteering = void 0;
const applyCachePolicy_js_1 = require("../../cache/applyCachePolicy.js");
function defineSteering(opts) {
    if (!opts.id || opts.id.trim().length === 0) {
        throw new Error('defineSteering: `id` is required and must be non-empty.');
    }
    if (!opts.prompt || opts.prompt.length === 0) {
        throw new Error(`defineSteering(${opts.id}): \`prompt\` is required.`);
    }
    const cacheMetadata = (0, applyCachePolicy_js_1.cachePolicyMetadata)('steering', opts.cache);
    return Object.freeze({
        id: opts.id,
        ...(opts.description && { description: opts.description }),
        flavor: 'steering',
        trigger: { kind: 'always' },
        inject: { systemPrompt: opts.prompt },
        metadata: Object.freeze(cacheMetadata),
    });
}
exports.defineSteering = defineSteering;
//# sourceMappingURL=defineSteering.js.map