@framers/agentos 0.13.2 → 0.13.3

package/dist/safety/guardrails/builtin/PhraseListGuardrail.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @module guardrails/builtin/PhraseListGuardrail
+ *
+ * A guard over a reviewed list of phrases. Each entry blocks on a match, or asks a judge whether the match, read in
+ * its context, crosses the rule. A blocked reply can be answered with a fixed replacement per rule, so a product's
+ * safety templates reach the person in place of the model's words.
+ *
+ * The text is normalised before matching (NFKC, case folded, zero-width characters and combining marks removed,
+ * common Cyrillic and Greek look-alikes mapped to Latin letters, curly quotes straightened, whitespace collapsed), so
+ * a phrase cannot slip past by a lookalike letter or an invisible joiner.
+ *
+ * The guard fails closed: a judge that throws, answers nothing usable, or answers with too little confidence blocks.
+ */
+import type { ExtensionPack } from '../../../extensions/manifest';
+import type { FallbackProviderEntry } from '../../../api/generateText';
+import { type JudgeLlmConfig } from '../../../core/llm/providers/judge-config';
+import { type GuardrailConfig, type GuardrailContext, type GuardrailEvaluationResult, type GuardrailInputPayload, type GuardrailOutputPayload, type IGuardrailService } from '../IGuardrailService';
+export interface PhraseEntry {
+    phrase: string;
+    /**
+     * `word`: the phrase between word boundaries; `substring`: anywhere; `regex`: the phrase is a regular expression.
+     * Every entry runs over the normalised text (lower case, marks and zero-width characters removed, look-alike
+     * letters mapped to Latin, quotes straightened): a word or substring phrase is normalised the same way before it is
+     * compiled, while a regex source is compiled as written, so write a regex in that normalised form.
+     */
+    match: 'word' | 'substring' | 'regex';
+    /** `block`: a match blocks; `judge`: the judge decides whether the match, in context, crosses the rule. */
+    onMatch: 'block' | 'judge';
+    /** The rule the entry belongs to: the block's `reasonCode` and the key of its replacement. */
+    ruleId?: string;
+}
+export interface PhraseListSnapshot {
+    version: string;
+    reviewedAt: string;
+    reviewedBy: string;
+    entries: PhraseEntry[];
+}
+export interface PhraseListSource {
+    load(): Promise<PhraseListSnapshot>;
+}
+export interface PhraseJudgeVerdict {
+    block: boolean;
+    confidence: number;
+    reason?: string;
+}
+export interface PhraseJudge {
+    judge(text: string, matched: readonly PhraseEntry[], context: GuardrailContext): Promise<PhraseJudgeVerdict>;
+}
+export interface PhraseListGuardrailOptions {
+    id: string;
+    source: PhraseListSource;
+    /** Required when any entry is `judge`. */
+    judge?: PhraseJudge;
+    /** A judge's block counts only at or above this confidence; a lower one blocks all the same (fail closed). Default 0.7. */
+    judgeThreshold?: number;
+    /** The stages the guard evaluates. Default both. */
+    stages?: Array<'input' | 'output'>;
+    /** The reply a block is answered with when no rule's own replacement applies. */
+    replacementText?: string;
+    /** The reply for a rule's block. */
+    replacementFor?(ruleId: string): string | undefined;
+    /** The deadline for one evaluation, judge included. Default 8 seconds. */
+    timeoutMs?: number;
+    /** Replaces the built-in normalisation. */
+    normalize?(text: string): string;
+}
+/** The built-in normalisation, applied alike to the list and to every text judged. */
+export declare function normalizePhraseText(text: string): string;
+/** A list held in code or built from the product's own files. */
+export declare class StaticPhraseListSource implements PhraseListSource {
+    private readonly snapshot;
+    constructor(snapshot: PhraseListSnapshot);
+    load(): Promise<PhraseListSnapshot>;
+}
+export declare class PhraseListGuardrail implements IGuardrailService {
+    private readonly opts;
+    readonly id: string;
+    readonly config: GuardrailConfig;
+    private compiled;
+    private loaded;
+    private readonly normalize;
+    private readonly stages;
+    private constructor();
+    /** Loads the list and compiles it. Refuses a list that does not load, is empty, or has judge entries and no judge. */
+    static create(opts: PhraseListGuardrailOptions): Promise<PhraseListGuardrail>;
+    /** The list in force: its version and when and by whom it was reviewed. */
+    get snapshot(): PhraseListSnapshot | null;
+    /**
+     * Loads the list again and swaps it in whole. A list that fails to load or compile leaves the last good one in force
+     * (and throws, so the caller hears of it).
+     */
+    reload(): Promise<void>;
+    evaluateInput({ input, context }: GuardrailInputPayload): Promise<GuardrailEvaluationResult | null>;
+    evaluateOutput({ chunk, context }: GuardrailOutputPayload): Promise<GuardrailEvaluationResult | null>;
+    private block;
+    private evaluateText;
+}
+/** A judge on a language model: asked whether the matched phrases, read in the text, cross the rule's criteria. */
+export declare function createLlmPhraseJudge(opts: JudgeLlmConfig & {
+    criteria: string;
+    apiKey?: string;
+    baseUrl?: string;
+    /** The providers the call may fall back to. Default none: an undefined chain would reach any provider whose key the host holds. */
+    fallbackProviders?: FallbackProviderEntry[];
+    timeoutMs?: number;
+}): PhraseJudge;
+/** The guard as an extension pack, for `extensionManifest.packs: [{ factory: () => createPhraseListPack(guard) }]`. */
+export declare function createPhraseListPack(guard: PhraseListGuardrail): ExtensionPack;
+//# sourceMappingURL=PhraseListGuardrail.d.ts.map

package/dist/safety/guardrails/builtin/PhraseListGuardrail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhraseListGuardrail.d.ts","sourceRoot":"","sources":["../../../../src/safety/guardrails/builtin/PhraseListGuardrail.ts"],"names":[],"mappings":"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"}

package/dist/safety/guardrails/builtin/PhraseListGuardrail.js

@@ -0,0 +1,180 @@
+import { EXTENSION_KIND_GUARDRAIL } from '../../../extensions/types.js';
+import { resolveJudgeLlm } from '../../../core/llm/providers/judge-config.js';
+import { AgentOSResponseChunkType } from '../../../api/types/AgentOSResponse.js';
+import { GuardrailAction, } from '../IGuardrailService.js';
+const ZERO_WIDTH = /[\u00AD\u180E\u200B-\u200F\u202A-\u202E\u2060-\u2064\uFEFF]/g;
+const LOOKALIKES = {
+    а: 'a', в: 'b', е: 'e', ё: 'e', к: 'k', м: 'm', н: 'h', о: 'o', р: 'p', с: 'c', т: 't', у: 'y', х: 'x', і: 'i', ї: 'i', ј: 'j', ѕ: 's', ԁ: 'd', һ: 'h', ӏ: 'l', ԛ: 'q', ԝ: 'w',
+    α: 'a', β: 'b', ε: 'e', η: 'n', ι: 'i', κ: 'k', ν: 'v', ο: 'o', ρ: 'p', τ: 't', υ: 'u', χ: 'x', ϲ: 'c', ɡ: 'g',
+};
+const LOOKALIKE_PATTERN = new RegExp(`[${Object.keys(LOOKALIKES).join('')}]`, 'g');
+/** The built-in normalisation, applied alike to the list and to every text judged. */
+export function normalizePhraseText(text) {
+    return text
+        .normalize('NFKC')
+        .toLowerCase()
+        .replace(ZERO_WIDTH, '')
+        .normalize('NFD')
+        .replace(/\p{M}+/gu, '')
+        .normalize('NFC')
+        .replace(LOOKALIKE_PATTERN, (ch) => LOOKALIKES[ch] ?? ch)
+        .replace(/[‘’‛′]/g, "'")
+        .replace(/[“”‟″]/g, '"')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+function compile(entries, normalize) {
+    return entries.map((entry) => {
+        if (entry.match === 'regex') {
+            const re = new RegExp(entry.phrase, 'iu');
+            return { entry, test: (t) => re.test(t) };
+        }
+        const phrase = normalize(entry.phrase);
+        if (!phrase)
+            throw new Error(`the phrase list holds an empty phrase${entry.ruleId ? ` under ${entry.ruleId}` : ''}`);
+        if (entry.match === 'substring')
+            return { entry, test: (t) => t.includes(phrase) };
+        const re = new RegExp(`(?<![\\p{L}\\p{N}])${escapeRegExp(phrase)}(?![\\p{L}\\p{N}])`, 'u');
+        return { entry, test: (t) => re.test(t) };
+    });
+}
+/** A list held in code or built from the product's own files. */
+export class StaticPhraseListSource {
+    constructor(snapshot) {
+        this.snapshot = snapshot;
+    }
+    async load() {
+        return this.snapshot;
+    }
+}
+export class PhraseListGuardrail {
+    constructor(opts) {
+        this.opts = opts;
+        this.compiled = [];
+        this.loaded = null;
+        this.id = opts.id;
+        this.config = { failClosed: true, timeoutMs: opts.timeoutMs ?? 8000, canSanitize: false, evaluateStreamingChunks: false };
+        this.normalize = opts.normalize ?? normalizePhraseText;
+        this.stages = new Set(opts.stages ?? ['input', 'output']);
+    }
+    /** Loads the list and compiles it. Refuses a list that does not load, is empty, or has judge entries and no judge. */
+    static async create(opts) {
+        const guard = new PhraseListGuardrail(opts);
+        await guard.reload();
+        return guard;
+    }
+    /** The list in force: its version and when and by whom it was reviewed. */
+    get snapshot() {
+        return this.loaded;
+    }
+    /**
+     * Loads the list again and swaps it in whole. A list that fails to load or compile leaves the last good one in force
+     * (and throws, so the caller hears of it).
+     */
+    async reload() {
+        const snapshot = await this.opts.source.load();
+        if (!snapshot || !Array.isArray(snapshot.entries) || snapshot.entries.length === 0) {
+            throw new Error(`the phrase list for ${this.id} is empty`);
+        }
+        if (!this.opts.judge && snapshot.entries.some((e) => e.onMatch === 'judge')) {
+            throw new Error(`the phrase list for ${this.id} has judge entries and the guard has no judge`);
+        }
+        const compiled = compile(snapshot.entries, this.normalize);
+        // the swap happens only once the whole list compiled
+        this.compiled = compiled;
+        this.loaded = snapshot;
+    }
+    async evaluateInput({ input, context }) {
+        if (!this.stages.has('input') || typeof input.textInput !== 'string' || !input.textInput)
+            return null;
+        return this.evaluateText(input.textInput, context);
+    }
+    async evaluateOutput({ chunk, context }) {
+        if (!this.stages.has('output') || chunk.type !== AgentOSResponseChunkType.FINAL_RESPONSE)
+            return null;
+        const text = chunk.finalResponseText;
+        if (typeof text !== 'string' || !text)
+            return null;
+        return this.evaluateText(text, context);
+    }
+    block(entry, reason) {
+        const ruleId = entry.ruleId ?? 'PHRASE_LIST';
+        const replacement = (entry.ruleId ? this.opts.replacementFor?.(entry.ruleId) : undefined) ?? this.opts.replacementText;
+        return {
+            action: GuardrailAction.BLOCK,
+            reason,
+            reasonCode: ruleId,
+            metadata: { guardrailId: this.id, ruleId, listVersion: this.loaded?.version },
+            ...(replacement ? { replacementText: replacement } : {}),
+        };
+    }
+    async evaluateText(text, context) {
+        const normalized = this.normalize(text);
+        const hits = this.compiled.filter((c) => c.test(normalized)).map((c) => c.entry);
+        if (hits.length === 0)
+            return null;
+        const blocking = hits.find((h) => h.onMatch === 'block');
+        if (blocking)
+            return this.block(blocking, 'The text matched a phrase on the reviewed list.');
+        const toJudge = hits.filter((h) => h.onMatch === 'judge');
+        const threshold = this.opts.judgeThreshold ?? 0.7;
+        let verdict = null;
+        try {
+            verdict = await this.opts.judge.judge(text, toJudge, context);
+        }
+        catch {
+            return this.block(toJudge[0], 'The judge could not answer, so the match blocks.');
+        }
+        const usable = verdict && typeof verdict.block === 'boolean' && typeof verdict.confidence === 'number' && Number.isFinite(verdict.confidence);
+        if (!usable)
+            return this.block(toJudge[0], 'The judge gave no usable answer, so the match blocks.');
+        if (verdict.block)
+            return this.block(toJudge[0], verdict.reason ?? 'The judge found the match crosses the rule.');
+        if (verdict.confidence < threshold)
+            return this.block(toJudge[0], 'The judge was not sure enough that the match is safe, so it blocks.');
+        return null;
+    }
+}
+/** A judge on a language model: asked whether the matched phrases, read in the text, cross the rule's criteria. */
+export function createLlmPhraseJudge(opts) {
+    const sel = resolveJudgeLlm({ model: opts.model, provider: opts.provider, effort: opts.effort });
+    return {
+        async judge(text, matched) {
+            const { generateText } = await import('../../../api/generateText.js');
+            const system = [
+                'You judge whether a text crosses a rule. A reviewed phrase list matched the phrases named below; decide whether, read in the text, they cross the rule.',
+                '',
+                '## The rule',
+                opts.criteria,
+                '',
+                'Respond with ONLY a JSON object: { "block": boolean, "confidence": number between 0 and 1, "reason": string }. No other text.',
+            ].join('\n');
+            const prompt = [`Matched phrases: ${matched.map((m) => JSON.stringify(m.phrase)).join(', ')}`, '', 'Text:', text].join('\n');
+            const result = await generateText({
+                provider: sel.provider,
+                model: sel.model,
+                system,
+                prompt,
+                temperature: 0,
+                maxTokens: 200,
+                requestTimeout: opts.timeoutMs ?? 6000,
+                ...(sel.effort !== undefined ? { effort: sel.effort } : {}),
+                ...(opts.apiKey ? { apiKey: opts.apiKey } : {}),
+                ...(opts.baseUrl ? { baseUrl: opts.baseUrl } : {}),
+                fallbackProviders: opts.fallbackProviders ?? [],
+            });
+            const json = result.text.match(/\{[\s\S]*\}/)?.[0];
+            const parsed = json ? JSON.parse(json) : {};
+            return { block: parsed.block, confidence: parsed.confidence, reason: typeof parsed.reason === 'string' ? parsed.reason : undefined };
+        },
+    };
+}
+/** The guard as an extension pack, for `extensionManifest.packs: [{ factory: () => createPhraseListPack(guard) }]`. */
+export function createPhraseListPack(guard) {
+    return {
+        name: `phrase-list:${guard.id}`,
+        descriptors: [{ id: guard.id, kind: EXTENSION_KIND_GUARDRAIL, payload: guard }],
+    };
+}
+//# sourceMappingURL=PhraseListGuardrail.js.map

package/dist/safety/guardrails/builtin/PhraseListGuardrail.js.map

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

package/dist/safety/guardrails/guardrailDispatcher.d.ts

@@ -45,6 +45,26 @@ export interface GuardrailOutputOptions {
     inputEvaluations?: GuardrailEvaluationResult[] | null;
     /** RAG sources to thread through to output guardrails for grounding verification */
     ragSources?: import('../../cognition/rag').RagRetrievedChunk[];
+    /**
+     * Hold every TEXT_DELTA until the final guards have judged the whole reply. Allowed or flagged, the held deltas
+     * go out before the final chunk; blocked or sanitized, they are dropped, so the caller never sees text the guards
+     * refused. An actionable tool call closes the window: the text so far is judged as a final reply before it.
+     */
+    holdUntilFinal?: boolean;
+    /** Called once with the final verdict on the reply: blocked, sanitized, flagged or allowed. A throw is logged and ignored. */
+    onVerdict?: (verdict: GuardrailOutputVerdict) => void | Promise<void>;
+}
+/** The verdict on a reply, as {@link GuardrailOutputOptions.onVerdict} receives it. */
+export interface GuardrailOutputVerdict {
+    streamId: string;
+    action: GuardrailAction;
+    /** The id of the guard that blocked, when it has one. */
+    guardrailId?: string;
+    reasonCode?: string;
+    /** The text the caller receives: the replacement after a block with one, the reply after a pass, else null. */
+    finalText: string | null;
+    /** The reply's text as the guards judged it, before any rewrite; null for a verdict on a streamed delta, which judged no whole reply. */
+    originalText: string | null;
 }
 /**
  * Metadata entry attached to response chunks.

package/dist/safety/guardrails/guardrailDispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guardrailDispatcher.d.ts","sourceRoot":"","sources":["../../../src/safety/guardrails/guardrailDispatcher.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EACL,eAAe,EAGhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAG7B;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,SAAS,GAC3D,iBAAiB,EAAE,CAMrB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,iBAAiB,GACrB,GAAG,IAAI,iBAAiB,GAAG;IAC5B,cAAc,EAAE,WAAW,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CAAC;CAClE,CAEA;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,cAAc,EAAE,YAAY,CAAC;IAE7B,iGAAiG;IACjG,UAAU,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAE9C,qEAAqE;IACrE,WAAW,CAAC,EAAE,yBAAyB,EAAE,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,yBAAyB,EAAE,GAAG,IAAI,CAAC;IAEtD,oFAAoF;IACpF,UAAU,CAAC,EAAE,OAAO,qBAAqB,EAAE,iBAAiB,EAAE,CAAC;CAChE;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,SAAS,EAC5D,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAIhC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAuB,4BAA4B,CACjD,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,yBAAyB,EACrC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,CAkBlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAuB,oBAAoB,CACzC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,SAAS,EAC5D,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,EACxD,OAAO,EAAE,sBAAsB,GAC9B,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,CAIlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,yBAAyB,GAAG,sBAAsB,CAOjG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE;IACL,KAAK,CAAC,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;IAC1D,MAAM,CAAC,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;CAC5D,GACA,eAAe,CAkCjB"}
+{"version":3,"file":"guardrailDispatcher.d.ts","sourceRoot":"","sources":["../../../src/safety/guardrails/guardrailDispatcher.ts"],"names":[],"mappings":"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"}

package/dist/safety/guardrails/guardrailDispatcher.js.map

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

package/dist/safety/guardrails/index.d.ts

@@ -46,8 +46,10 @@
  * ```
  */
 export { GuardrailAction, type GuardrailConfig, type GuardrailContext, type GuardrailEvaluationResult, type GuardrailInputPayload, type GuardrailOutputPayload, type IGuardrailService, } from './IGuardrailService';
-export { createGuardrailBlockedStream, evaluateInputGuardrails, type GuardrailInputOutcome, type GuardrailOutputOptions, wrapOutputGuardrails, } from './guardrailDispatcher';
+export { createGuardrailBlockedStream, evaluateInputGuardrails, type GuardrailInputOutcome, type GuardrailOutputOptions, type GuardrailOutputVerdict, wrapOutputGuardrails, } from './guardrailDispatcher';
+export { assertRequiredGuardrails, checkRequiredGuardrails, withRequiredPosture, type ActiveGuardrail, type GuardrailStage, type RequiredGuardrailReport, type RequiredGuardrailSpec, } from './requiredGuardrails';
 export { ParallelGuardrailDispatcher } from './ParallelGuardrailDispatcher';
+export { PhraseListGuardrail, StaticPhraseListSource, createLlmPhraseJudge, createPhraseListPack, normalizePhraseText, type PhraseEntry, type PhraseJudge, type PhraseJudgeVerdict, type PhraseListGuardrailOptions, type PhraseListSnapshot, type PhraseListSource, } from './builtin/PhraseListGuardrail';
 export { type CrossAgentOutputPayload, type ICrossAgentGuardrailService, isCrossAgentGuardrail, shouldObserveAgent, } from './ICrossAgentGuardrailService';
 export { SentenceBoundaryBuffer } from './SentenceBoundaryBuffer';
 export { type CrossAgentEvaluationResult, type CrossAgentGuardrailContext, evaluateCrossAgentGuardrails, filterCrossAgentGuardrails, wrapWithCrossAgentGuardrails, } from './crossAgentGuardrailDispatcher';

package/dist/safety/guardrails/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/safety/guardrails/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAGH,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAG5E,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/safety/guardrails/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAGH,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAG5E,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC"}

package/dist/safety/guardrails/index.js

@@ -49,8 +49,12 @@
 export { GuardrailAction, } from './IGuardrailService.js';
 // Guardrail dispatcher functions
 export { createGuardrailBlockedStream, evaluateInputGuardrails, wrapOutputGuardrails, } from './guardrailDispatcher.js';
+// Guards a deployment requires: the boot and request checks and the fail-closed posture
+export { assertRequiredGuardrails, checkRequiredGuardrails, withRequiredPosture, } from './requiredGuardrails.js';
 // Two-phase parallel guardrail dispatcher
 export { ParallelGuardrailDispatcher } from './ParallelGuardrailDispatcher.js';
+// A guard over a reviewed phrase list, with a judge behind it and a fixed reply per rule
+export { PhraseListGuardrail, StaticPhraseListSource, createLlmPhraseJudge, createPhraseListPack, normalizePhraseText, } from './builtin/PhraseListGuardrail.js';
 // Cross-agent guardrail interface and types
 export { isCrossAgentGuardrail, shouldObserveAgent, } from './ICrossAgentGuardrailService.js';
 // Sentence boundary buffer for streaming evaluation

package/dist/safety/guardrails/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/safety/guardrails/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,qCAAqC;AACrC,OAAO,EACL,eAAe,GAOhB,MAAM,qBAAqB,CAAC;AAE7B,iCAAiC;AACjC,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EAGvB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,0CAA0C;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,4CAA4C;AAC5C,OAAO,EAGL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAEvC,oDAAoD;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,mCAAmC;AACnC,OAAO,EAGL,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/safety/guardrails/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,qCAAqC;AACrC,OAAO,EACL,eAAe,GAOhB,MAAM,qBAAqB,CAAC;AAE7B,iCAAiC;AACjC,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EAIvB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,wFAAwF;AACxF,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,GAKpB,MAAM,sBAAsB,CAAC;AAE9B,0CAA0C;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,yFAAyF;AACzF,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GAOpB,MAAM,+BAA+B,CAAC;AAEvC,4CAA4C;AAC5C,OAAO,EAGL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAEvC,oDAAoD;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,mCAAmC;AACnC,OAAO,EAGL,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC"}

package/dist/safety/guardrails/requiredGuardrails.d.ts

@@ -0,0 +1,34 @@
+import { type IGuardrailService } from './IGuardrailService';
+export type GuardrailStage = 'input' | 'output';
+export interface RequiredGuardrailSpec {
+    /** The guard's id: its `IGuardrailService.id`, else the id of the descriptor it was registered under. */
+    id: string;
+    /** The stages it must evaluate: a guard required on `output` must implement `evaluateOutput`. */
+    stages: GuardrailStage[];
+    /** Its deadline per evaluation; past it the guard blocks. */
+    timeoutMs: number;
+}
+export interface ActiveGuardrail {
+    id: string;
+    service: IGuardrailService;
+}
+export interface RequiredGuardrailReport {
+    ok: boolean;
+    /** Required ids with no active guard. */
+    missing: string[];
+    /** Required stages an active guard does not implement. */
+    missingStage: Array<{
+        id: string;
+        stage: GuardrailStage;
+    }>;
+}
+/** Compares the active guards with the required ones. */
+export declare function checkRequiredGuardrails(active: readonly ActiveGuardrail[], required: readonly RequiredGuardrailSpec[]): RequiredGuardrailReport;
+/** Throws a configuration error naming every missing guard and stage. */
+export declare function assertRequiredGuardrails(active: readonly ActiveGuardrail[], required: readonly RequiredGuardrailSpec[]): void;
+/**
+ * The guard as a required one runs: under its id, fail-closed, with the spec's deadline, and with a malformed answer
+ * turned into a block. The original service is not changed.
+ */
+export declare function withRequiredPosture(id: string, svc: IGuardrailService, spec: RequiredGuardrailSpec): IGuardrailService;
+//# sourceMappingURL=requiredGuardrails.d.ts.map

package/dist/safety/guardrails/requiredGuardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requiredGuardrails.d.ts","sourceRoot":"","sources":["../../../src/safety/guardrails/requiredGuardrails.ts"],"names":[],"mappings":"AAQA,OAAO,EAAmD,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE9G,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC,yGAAyG;IACzG,EAAE,EAAE,MAAM,CAAC;IACX,iGAAiG;IACjG,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,yDAAyD;AACzD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,EAAE,QAAQ,EAAE,SAAS,qBAAqB,EAAE,GAAG,uBAAuB,CAe/I;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,EAAE,QAAQ,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CAW7H;AAWD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,qBAAqB,GAAG,iBAAiB,CAYtH"}

package/dist/safety/guardrails/requiredGuardrails.js

@@ -0,0 +1,68 @@
+/**
+ * @module guardrails/requiredGuardrails
+ *
+ * Guards a deployment cannot run without. A product names them by id and stage; AgentOS refuses to start when one is
+ * missing, refuses a request when one has gone missing since, and runs each one fail-closed with a deadline, so a
+ * guard that throws, hangs or answers nonsense blocks instead of letting the reply through.
+ */
+import { GMIError, GMIErrorCode } from '../../core/utils/errors.js';
+import { GuardrailAction } from './IGuardrailService.js';
+/** Compares the active guards with the required ones. */
+export function checkRequiredGuardrails(active, required) {
+    const missing = [];
+    const missingStage = [];
+    for (const spec of required) {
+        const found = active.find((a) => a.id === spec.id);
+        if (!found) {
+            missing.push(spec.id);
+            continue;
+        }
+        for (const stage of spec.stages) {
+            const implemented = stage === 'input' ? typeof found.service.evaluateInput === 'function' : typeof found.service.evaluateOutput === 'function';
+            if (!implemented)
+                missingStage.push({ id: spec.id, stage });
+        }
+    }
+    return { ok: missing.length === 0 && missingStage.length === 0, missing, missingStage };
+}
+/** Throws a configuration error naming every missing guard and stage. */
+export function assertRequiredGuardrails(active, required) {
+    const report = checkRequiredGuardrails(active, required);
+    if (report.ok)
+        return;
+    const parts = [
+        ...report.missing.map((id) => `${id} is not active`),
+        ...report.missingStage.map(({ id, stage }) => `${id} does not evaluate ${stage}`),
+    ];
+    throw new GMIError(`Required guardrails are missing: ${parts.join('; ')}.`, GMIErrorCode.CONFIGURATION_ERROR, {
+        missing: report.missing,
+        missingStage: report.missingStage,
+    });
+}
+const ACTIONS = new Set(Object.values(GuardrailAction));
+/** An evaluation whose action is not one of {@link GuardrailAction} is a malformed answer, and a required guard's malformed answer blocks. */
+function wellFormed(evaluation) {
+    if (evaluation === null || evaluation === undefined)
+        return null;
+    if (typeof evaluation === 'object' && ACTIONS.has(String(evaluation.action)))
+        return evaluation;
+    return { action: GuardrailAction.BLOCK, reason: 'The guardrail answered with no recognised action.', reasonCode: 'GUARDRAIL_MALFORMED', metadata: { failClosed: true } };
+}
+/**
+ * The guard as a required one runs: under its id, fail-closed, with the spec's deadline, and with a malformed answer
+ * turned into a block. The original service is not changed.
+ */
+export function withRequiredPosture(id, svc, spec) {
+    const wrapped = {
+        id,
+        config: { ...svc.config, failClosed: true, timeoutMs: spec.timeoutMs },
+    };
+    if (typeof svc.evaluateInput === 'function') {
+        wrapped.evaluateInput = async (payload) => wellFormed(await svc.evaluateInput(payload));
+    }
+    if (typeof svc.evaluateOutput === 'function') {
+        wrapped.evaluateOutput = async (payload) => wellFormed(await svc.evaluateOutput(payload));
+    }
+    return wrapped;
+}
+//# sourceMappingURL=requiredGuardrails.js.map

package/dist/safety/guardrails/requiredGuardrails.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "description": "AgentOS: open-source TypeScript framework for autonomous AI agents. Unified graph orchestration, cognitive memory, runtime tool forging, multi-tier guardrails, voice pipeline, and 11 LLM providers.",
   "homepage": "https://agentos.sh",
   "repository": {