wotann 0.5.39 → 0.5.41

package/dist/providers/sticky-rotation-wire.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Sticky-Rotation Wire — integration layer between {@link StickyRotation}
+ * and {@link CredentialPool}.
+ *
+ * WHY A WIRE INSTEAD OF DIRECT EMBEDDING?
+ * The integration option we picked is Option B (wrap, not replace). The
+ * existing `getCredential()` switch on `rotationStrategy` keeps every
+ * pre-wire behaviour intact — sticky-rotation is consulted ONLY when:
+ *   1. The feature gate `WOTANN_STICKY_ROTATION=1` is set, OR
+ *   2. The caller supplied a sticky config on the pool.
+ *
+ * When the sticky layer "votes to stay" (returns a current credential),
+ * the pool returns that credential without consulting its strategy. When
+ * sticky-rotation votes to advance (returns `null` from {@link consult}),
+ * the pool falls through to the original strategy switch. This means:
+ *
+ *  - Existing tests, existing behaviours: unchanged.
+ *  - With the gate ON: hot conversations reuse the same credential for
+ *    `stickyLimit` calls so Anthropic's prompt cache keeps warming up
+ *    the same prefix — up to 10x cache savings on the cached portion.
+ *  - Auth/rate-limit errors call {@link forceRotate} so we don't burn
+ *    the sticky budget on a credential we already know is unusable.
+ *
+ * NO TOKEN VALUES ever flow through this wire. We rotate credential IDs
+ * (opaque handles); the pool dereferences id -> AccountCredential when
+ * the caller is ready. This preserves the Quality Bar #6 security rule.
+ *
+ * NOT a singleton. One instance per `CredentialPool` per provider. The
+ * caller (CredentialPool) owns the lifecycle so test isolation is
+ * straightforward — every fresh `CredentialPool` builds its own wire.
+ */
+import { StickyRotation } from "./sticky-rotation.js";
+import type { ProviderName } from "../core/types.js";
+/**
+ * Resolve the sticky-rotation feature gate from the environment.
+ *
+ * Truthy values: "1", "true" (case-insensitive). Anything else is OFF.
+ * The lookup happens at call-time, NOT at module load, so tests can
+ * mutate `process.env.WOTANN_STICKY_ROTATION` between cases without
+ * needing module reload tricks.
+ */
+export declare function isStickyRotationEnabled(): boolean;
+/**
+ * Resolve the sticky-rotation debug gate. When ON, the wire emits debug
+ * lines to stderr via `process.stderr.write` (the existing provider
+ * diagnostic channel — see codex-adapter.ts:339).
+ */
+export declare function isStickyRotationDebugEnabled(): boolean;
+export interface StickyWireConfig {
+    /** Override the default sticky limit (10). Same semantics as StickyRotation. */
+    readonly stickyLimit?: number;
+    /**
+     * Force the wire ON even if the env gate is OFF. Used by callers that
+     * want sticky behaviour unconditionally (e.g. integration tests).
+     */
+    readonly forceEnabled?: boolean;
+}
+/**
+ * Result of {@link StickyRotationWire.consult}.
+ *
+ * - `kind: "stay"`  — sticky-rotation votes to reuse the current id;
+ *                     the pool should return that id's credential.
+ * - `kind: "advance"` — sticky-rotation has exhausted its budget OR no
+ *                       active rotation exists yet for the provider;
+ *                       the pool should defer to its strategy switch.
+ * - `kind: "no-id"`  — the resolved id is no longer in the pool (it was
+ *                      removed / blacklisted); the pool should advance.
+ */
+export type StickyConsultation = {
+    readonly kind: "stay";
+    readonly credentialId: string;
+    readonly usesRemaining: number;
+} | {
+    readonly kind: "advance";
+} | {
+    readonly kind: "no-id";
+};
+/**
+ * Per-provider sticky-rotation state. Built lazily — we only create a
+ * StickyRotation for a provider when the wire is actively consulted for
+ * it. Keeps the memory footprint zero for providers that never opt-in.
+ */
+export declare class StickyRotationWire {
+    private readonly rotators;
+    private readonly config;
+    constructor(config?: StickyWireConfig);
+    /**
+     * Is the sticky layer active for THIS call? Combines the env gate and
+     * the `forceEnabled` config override. Evaluated per-call so tests can
+     * flip the gate between cases.
+     */
+    isActive(): boolean;
+    /**
+     * Consult the sticky rotator for a provider.
+     *
+     * The caller passes the currently-available credential IDs (already
+     * filtered for blacklist / rate-limit / billing) in their preferred
+     * order. The wire makes one of three decisions:
+     *
+     *   1. Sticky is inactive       -> returns `advance` (caller's strategy wins)
+     *   2. No active rotator yet    -> builds one from `candidateIds` and returns `advance`
+     *   3. Active rotator exists    -> {@link StickyRotation.next} returns an id;
+     *                                  if id is still in `candidateIds`, vote `stay`;
+     *                                  otherwise vote `no-id` (caller should advance)
+     *
+     * IMPORTANT: This method calls `next()` on the rotator (i.e. it
+     * consumes a use). Callers that want to inspect without consuming
+     * should use {@link peek} instead.
+     */
+    consult(provider: ProviderName, candidateIds: readonly string[]): StickyConsultation;
+    /**
+     * Manually force the rotator for a provider to advance. Intended for
+     * auth-error / 429 / 503 hits where the current credential is known
+     * bad — we don't want to keep burning the sticky budget on it.
+     *
+     * No-op if there is no rotator for this provider yet.
+     */
+    forceRotate(provider: ProviderName): void;
+    /**
+     * Snapshot diagnostic info for a provider — used by tests / status UI.
+     * Returns `null` when no rotator has been built for the provider.
+     */
+    stats(provider: ProviderName): ReturnType<StickyRotation["stats"]> | null;
+    /**
+     * Drop the rotator for a provider (e.g. when the credentials list
+     * changes underneath the wire and we want to rebuild fresh on next
+     * consult). Quality Bar #19 — explicit reset rather than a dead
+     * zombie instance.
+     */
+    reset(provider?: ProviderName): void;
+    private debug;
+}
+//# sourceMappingURL=sticky-rotation-wire.d.ts.map

package/dist/providers/sticky-rotation-wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sticky-rotation-wire.d.ts","sourceRoot":"","sources":["../../src/providers/sticky-rotation-wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAKjD;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,OAAO,CAKtD;AAED,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACxF;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/B;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;IACzE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,MAAM,CAAC,EAAE,gBAAgB;IAIrC;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB;IA8CpF;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAOzC;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI;IAKzE;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI;IAQpC,OAAO,CAAC,KAAK;CAQd"}

package/dist/providers/sticky-rotation-wire.js

@@ -0,0 +1,185 @@
+/**
+ * Sticky-Rotation Wire — integration layer between {@link StickyRotation}
+ * and {@link CredentialPool}.
+ *
+ * WHY A WIRE INSTEAD OF DIRECT EMBEDDING?
+ * The integration option we picked is Option B (wrap, not replace). The
+ * existing `getCredential()` switch on `rotationStrategy` keeps every
+ * pre-wire behaviour intact — sticky-rotation is consulted ONLY when:
+ *   1. The feature gate `WOTANN_STICKY_ROTATION=1` is set, OR
+ *   2. The caller supplied a sticky config on the pool.
+ *
+ * When the sticky layer "votes to stay" (returns a current credential),
+ * the pool returns that credential without consulting its strategy. When
+ * sticky-rotation votes to advance (returns `null` from {@link consult}),
+ * the pool falls through to the original strategy switch. This means:
+ *
+ *  - Existing tests, existing behaviours: unchanged.
+ *  - With the gate ON: hot conversations reuse the same credential for
+ *    `stickyLimit` calls so Anthropic's prompt cache keeps warming up
+ *    the same prefix — up to 10x cache savings on the cached portion.
+ *  - Auth/rate-limit errors call {@link forceRotate} so we don't burn
+ *    the sticky budget on a credential we already know is unusable.
+ *
+ * NO TOKEN VALUES ever flow through this wire. We rotate credential IDs
+ * (opaque handles); the pool dereferences id -> AccountCredential when
+ * the caller is ready. This preserves the Quality Bar #6 security rule.
+ *
+ * NOT a singleton. One instance per `CredentialPool` per provider. The
+ * caller (CredentialPool) owns the lifecycle so test isolation is
+ * straightforward — every fresh `CredentialPool` builds its own wire.
+ */
+import { StickyRotation } from "./sticky-rotation.js";
+/**
+ * Resolve the sticky-rotation feature gate from the environment.
+ *
+ * Truthy values: "1", "true" (case-insensitive). Anything else is OFF.
+ * The lookup happens at call-time, NOT at module load, so tests can
+ * mutate `process.env.WOTANN_STICKY_ROTATION` between cases without
+ * needing module reload tricks.
+ */
+export function isStickyRotationEnabled() {
+    const raw = process.env["WOTANN_STICKY_ROTATION"];
+    if (raw === undefined)
+        return false;
+    const normalised = raw.toLowerCase();
+    return normalised === "1" || normalised === "true";
+}
+/**
+ * Resolve the sticky-rotation debug gate. When ON, the wire emits debug
+ * lines to stderr via `process.stderr.write` (the existing provider
+ * diagnostic channel — see codex-adapter.ts:339).
+ */
+export function isStickyRotationDebugEnabled() {
+    const raw = process.env["WOTANN_STICKY_ROTATION_DEBUG"];
+    if (raw === undefined)
+        return false;
+    const normalised = raw.toLowerCase();
+    return normalised === "1" || normalised === "true";
+}
+/**
+ * Per-provider sticky-rotation state. Built lazily — we only create a
+ * StickyRotation for a provider when the wire is actively consulted for
+ * it. Keeps the memory footprint zero for providers that never opt-in.
+ */
+export class StickyRotationWire {
+    rotators = new Map();
+    config;
+    constructor(config) {
+        this.config = config ?? {};
+    }
+    /**
+     * Is the sticky layer active for THIS call? Combines the env gate and
+     * the `forceEnabled` config override. Evaluated per-call so tests can
+     * flip the gate between cases.
+     */
+    isActive() {
+        return this.config.forceEnabled === true || isStickyRotationEnabled();
+    }
+    /**
+     * Consult the sticky rotator for a provider.
+     *
+     * The caller passes the currently-available credential IDs (already
+     * filtered for blacklist / rate-limit / billing) in their preferred
+     * order. The wire makes one of three decisions:
+     *
+     *   1. Sticky is inactive       -> returns `advance` (caller's strategy wins)
+     *   2. No active rotator yet    -> builds one from `candidateIds` and returns `advance`
+     *   3. Active rotator exists    -> {@link StickyRotation.next} returns an id;
+     *                                  if id is still in `candidateIds`, vote `stay`;
+     *                                  otherwise vote `no-id` (caller should advance)
+     *
+     * IMPORTANT: This method calls `next()` on the rotator (i.e. it
+     * consumes a use). Callers that want to inspect without consuming
+     * should use {@link peek} instead.
+     */
+    consult(provider, candidateIds) {
+        if (!this.isActive())
+            return { kind: "advance" };
+        if (candidateIds.length === 0)
+            return { kind: "advance" };
+        let rotator = this.rotators.get(provider);
+        if (!rotator) {
+            // First consult for this provider — build a fresh rotator from
+            // the current candidates. We don't consume a use on the build
+            // call (return `advance` so the caller's strategy chooses the
+            // first credential normally) because the rotator's natural
+            // contract is "call next() to get a credential". Mixing build +
+            // consume would cause the first credential to skip rotation
+            // accounting entirely.
+            rotator = new StickyRotation({
+                items: candidateIds,
+                stickyLimit: this.config.stickyLimit,
+                rotationKey: `cred-pool:${provider}`,
+            });
+            this.rotators.set(provider, rotator);
+            const id = rotator.next();
+            // Trace the build path so operators can confirm sticky kicked in.
+            this.debug(`built rotator for provider=${provider} items=${candidateIds.length} initial=${id}`);
+            // The initial id IS valid (it came from candidateIds) — vote stay.
+            // If it isn't in candidateIds (shouldn't happen because we built
+            // from candidateIds), fall through to no-id.
+            if (candidateIds.includes(id)) {
+                const stats = rotator.stats();
+                return { kind: "stay", credentialId: id, usesRemaining: stats.usesRemaining };
+            }
+            return { kind: "no-id" };
+        }
+        const id = rotator.next();
+        if (!candidateIds.includes(id)) {
+            // The id we'd reuse is no longer healthy (blacklisted / rate-limited
+            // / removed). Tell the caller to advance via their strategy.
+            this.debug(`id ${id} not in candidates (provider=${provider}); advancing`);
+            return { kind: "no-id" };
+        }
+        const stats = rotator.stats();
+        this.debug(`reused ${id} for provider=${provider} (uses remaining: ${stats.usesRemaining})`);
+        return { kind: "stay", credentialId: id, usesRemaining: stats.usesRemaining };
+    }
+    /**
+     * Manually force the rotator for a provider to advance. Intended for
+     * auth-error / 429 / 503 hits where the current credential is known
+     * bad — we don't want to keep burning the sticky budget on it.
+     *
+     * No-op if there is no rotator for this provider yet.
+     */
+    forceRotate(provider) {
+        const rotator = this.rotators.get(provider);
+        if (!rotator)
+            return;
+        rotator.forceRotate();
+        this.debug(`forceRotate fired for provider=${provider}`);
+    }
+    /**
+     * Snapshot diagnostic info for a provider — used by tests / status UI.
+     * Returns `null` when no rotator has been built for the provider.
+     */
+    stats(provider) {
+        const rotator = this.rotators.get(provider);
+        return rotator ? rotator.stats() : null;
+    }
+    /**
+     * Drop the rotator for a provider (e.g. when the credentials list
+     * changes underneath the wire and we want to rebuild fresh on next
+     * consult). Quality Bar #19 — explicit reset rather than a dead
+     * zombie instance.
+     */
+    reset(provider) {
+        if (provider) {
+            this.rotators.delete(provider);
+        }
+        else {
+            this.rotators.clear();
+        }
+    }
+    debug(line) {
+        if (!isStickyRotationDebugEnabled())
+            return;
+        // Match the existing provider debug pattern (codex-adapter.ts:339):
+        // write to stderr so it never pollutes stdout / chat. Prefix is
+        // grep-friendly: `WOTANN_STICKY_ROTATION_DEBUG=1 wotann 2>diag.log`
+        // then `grep '\[sticky\]' diag.log`.
+        process.stderr.write(`[sticky] ${line}\n`);
+    }
+}
+//# sourceMappingURL=sticky-rotation-wire.js.map

package/dist/providers/sticky-rotation-wire.js.map

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

package/dist/runtime-hooks/ttsr-rule.d.ts

@@ -0,0 +1,82 @@
+/**
+ * TTSR Rule - canonical shape + factory + markdown front-matter parser.
+ *
+ * Mirrors the oh-my-pi `Rule` capability (rule.ts) and the canonical
+ * `ttsr-condition` / `ttsr-scope` front-matter keys, but lives in
+ * WOTANN as a tiny, dependency-free runtime primitive.
+ *
+ * A `TTSRRule` is the structured form of an interrupt: when a
+ * streaming model produces a token that matches `condition` AND the
+ * current stream context matches `scope`, the orchestrator aborts
+ * the turn and injects `body` as a system reminder.
+ *
+ * This file is PURE. It does not touch streams; see ttsr-runner.ts
+ * for the per-token evaluation logic and ttsr.ts (middleware) for
+ * the orchestrator-facing wire.
+ */
+import { type ScopeFilter } from "./ttsr-scope.js";
+/**
+ * A single TTSR rule.
+ *
+ * - `id` is the stable identity used for one-shot bookkeeping. It
+ *   should be globally unique within a session (use file path,
+ *   slug, or hash).
+ * - `condition` is the RegExp tested against the streaming buffer
+ *   for the matching scope. Always non-global so `RegExp.test`
+ *   stays stateless.
+ * - `scope` restricts which stream kinds + tool calls the rule
+ *   listens to (see `ttsr-scope.ts`). Default permissive value is
+ *   `"any"` if the caller does not specify.
+ * - `body` is the injection text. The orchestrator wraps this in
+ *   a `<system-reminder>` block at retry time.
+ * - `oneShot` (optional, default true). When true, the rule fires
+ *   AT MOST once per session - the runner enforces this via
+ *   `acknowledgeFired`. When false, the rule may fire repeatedly.
+ */
+export interface TTSRRule {
+    readonly id: string;
+    readonly condition: RegExp;
+    readonly scope: ScopeFilter;
+    readonly body: string;
+    readonly oneShot?: boolean;
+}
+/**
+ * Options to `createTTSRRule`. Mirrors `TTSRRule` but accepts string
+ * conditions and an optional default scope.
+ */
+export interface CreateTTSRRuleOptions {
+    readonly id: string;
+    readonly condition: RegExp | string;
+    readonly scope?: ScopeFilter;
+    readonly body: string;
+    readonly oneShot?: boolean;
+    /** Regex flags when `condition` is a string. Default: no flags. */
+    readonly flags?: string;
+}
+/**
+ * Build a `TTSRRule` from a partial input, validating every field.
+ *
+ * Throws on invalid input - TTSR rules are not the place to fail
+ * silently. A malformed regex, an empty body, an unreachable scope,
+ * or an empty id all indicate a configuration bug that the caller
+ * needs to fix.
+ */
+export declare function createTTSRRule(opts: CreateTTSRRuleOptions): TTSRRule;
+/**
+ * Parse a markdown rule file into a TTSRRule, or `null` if the text
+ * does not declare TTSR front-matter (no `---` block, or no
+ * `ttsr-condition` key).
+ *
+ * `fallbackId` is used when the front-matter omits an `id`. Typical
+ * callers pass the source filename.
+ *
+ * Validation errors throw - same contract as `createTTSRRule`.
+ */
+export declare function parseRuleFromMarkdown(text: string, fallbackId?: string): TTSRRule | null;
+/**
+ * Round-trip helper: serialise a TTSRRule back to markdown
+ * front-matter. Used by the runner for `mem_save` snapshots and
+ * by tests for parse/serialise symmetry.
+ */
+export declare function serializeRuleToMarkdown(rule: TTSRRule): string;
+//# sourceMappingURL=ttsr-rule.d.ts.map

package/dist/runtime-hooks/ttsr-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttsr-rule.d.ts","sourceRoot":"","sources":["../../src/runtime-hooks/ttsr-rule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,QAAQ,CA4CpE;AA6GD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,QAAQ,GAAG,IAAI,CA+BpF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAe9D"}

package/dist/runtime-hooks/ttsr-rule.js

@@ -0,0 +1,207 @@
+/**
+ * TTSR Rule - canonical shape + factory + markdown front-matter parser.
+ *
+ * Mirrors the oh-my-pi `Rule` capability (rule.ts) and the canonical
+ * `ttsr-condition` / `ttsr-scope` front-matter keys, but lives in
+ * WOTANN as a tiny, dependency-free runtime primitive.
+ *
+ * A `TTSRRule` is the structured form of an interrupt: when a
+ * streaming model produces a token that matches `condition` AND the
+ * current stream context matches `scope`, the orchestrator aborts
+ * the turn and injects `body` as a system reminder.
+ *
+ * This file is PURE. It does not touch streams; see ttsr-runner.ts
+ * for the per-token evaluation logic and ttsr.ts (middleware) for
+ * the orchestrator-facing wire.
+ */
+import { isReachableScope } from "./ttsr-scope.js";
+/**
+ * Build a `TTSRRule` from a partial input, validating every field.
+ *
+ * Throws on invalid input - TTSR rules are not the place to fail
+ * silently. A malformed regex, an empty body, an unreachable scope,
+ * or an empty id all indicate a configuration bug that the caller
+ * needs to fix.
+ */
+export function createTTSRRule(opts) {
+    const id = (opts.id ?? "").trim();
+    if (id.length === 0) {
+        throw new Error("TTSR rule id must be a non-empty string");
+    }
+    const body = opts.body ?? "";
+    if (typeof body !== "string" || body.trim().length === 0) {
+        throw new Error(`TTSR rule '${id}' must have a non-empty body`);
+    }
+    // Normalize condition: regex passthrough; string compiles to RegExp.
+    // We strip the `g` flag because TTSR uses `RegExp.test`, and a sticky
+    // global state would make matches non-idempotent across calls.
+    let condition;
+    if (opts.condition instanceof RegExp) {
+        const flags = opts.condition.flags.replace(/g/g, "");
+        condition = new RegExp(opts.condition.source, flags);
+    }
+    else if (typeof opts.condition === "string") {
+        const flags = (opts.flags ?? "").replace(/g/g, "");
+        try {
+            condition = new RegExp(opts.condition, flags);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`TTSR rule '${id}' has invalid regex: ${msg}`);
+        }
+    }
+    else {
+        throw new Error(`TTSR rule '${id}' condition must be a RegExp or non-empty string`);
+    }
+    const scope = opts.scope ?? "any";
+    if (!isReachableScope(scope)) {
+        throw new Error(`TTSR rule '${id}' scope is unreachable (no tokens matched): '${scope}'`);
+    }
+    const oneShot = opts.oneShot ?? true;
+    return {
+        id,
+        condition,
+        scope,
+        body,
+        oneShot,
+    };
+}
+/**
+ * Slug a markdown filename or first-line heading into a rule id.
+ *
+ * Lowercases, replaces non-word runs with `-`, trims leading/trailing
+ * separators. Returns empty string for empty input.
+ */
+function slugify(s) {
+    return s
+        .toLowerCase()
+        .replace(/\.(md|mdc|markdown)$/i, "")
+        .replace(/[^\w]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/**
+ * Strip `/.../flags` regex literal wrappers if present, returning
+ * { source, flags }. If the value does not look like a regex literal
+ * we pass it through as the source with empty flags.
+ */
+function parseRegexLiteral(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    const m = /^\/(.+)\/([a-z]*)$/i.exec(trimmed);
+    if (m && typeof m[1] === "string") {
+        return { source: m[1], flags: m[2] ?? "" };
+    }
+    return { source: trimmed, flags: "" };
+}
+/**
+ * Tiny YAML-ish front-matter reader. We do NOT depend on a YAML lib.
+ * The keys we accept are simple scalars (string / boolean) and we
+ * trim/unquote them by hand. Anything that looks like a list value
+ * (joined with `, `) is preserved as a single string and forwarded
+ * to the scope tokenizer which already understands commas.
+ */
+function readFrontMatter(text) {
+    // Markdown front-matter delimited by `---` on its own line.
+    const m = /^---\s*\n([\s\S]*?)\n---\s*\n?/.exec(text);
+    if (!m) {
+        return undefined;
+    }
+    const head = m[1] ?? "";
+    const body = text.slice(m[0].length).trim();
+    const map = {};
+    for (const rawLine of head.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (line.length === 0 || line.startsWith("#"))
+            continue;
+        const idx = line.indexOf(":");
+        if (idx === -1)
+            continue;
+        const key = line.slice(0, idx).trim().toLowerCase();
+        let val = line.slice(idx + 1).trim();
+        if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+            val = val.slice(1, -1);
+        }
+        map[key] = val;
+    }
+    const conditionVal = map["ttsr-condition"] ??
+        map["ttsr_condition"] ??
+        map["condition"] ??
+        map["ttsr_trigger"] ??
+        undefined;
+    const scopeVal = map["ttsr-scope"] ?? map["ttsr_scope"] ?? map["scope"] ?? undefined;
+    const idVal = map["id"] ?? map["name"] ?? undefined;
+    const oneShotRaw = map["one-shot"] ?? map["oneshot"] ?? map["one_shot"];
+    const oneShot = typeof oneShotRaw === "string"
+        ? !["false", "no", "0", "off"].includes(oneShotRaw.toLowerCase())
+        : undefined;
+    return {
+        ...(idVal !== undefined ? { id: idVal } : {}),
+        ...(oneShot !== undefined ? { oneShot } : {}),
+        ...(conditionVal !== undefined ? { condition: conditionVal } : {}),
+        ...(scopeVal !== undefined ? { scope: scopeVal } : {}),
+        body,
+    };
+}
+/**
+ * Parse a markdown rule file into a TTSRRule, or `null` if the text
+ * does not declare TTSR front-matter (no `---` block, or no
+ * `ttsr-condition` key).
+ *
+ * `fallbackId` is used when the front-matter omits an `id`. Typical
+ * callers pass the source filename.
+ *
+ * Validation errors throw - same contract as `createTTSRRule`.
+ */
+export function parseRuleFromMarkdown(text, fallbackId = "") {
+    if (typeof text !== "string" || text.trim().length === 0) {
+        return null;
+    }
+    const fm = readFrontMatter(text);
+    if (!fm)
+        return null;
+    if (typeof fm.condition !== "string" || fm.condition.trim().length === 0) {
+        return null;
+    }
+    if (typeof fm.body !== "string" || fm.body.trim().length === 0) {
+        return null;
+    }
+    const literal = parseRegexLiteral(fm.condition);
+    if (!literal)
+        return null;
+    const idSource = fm.id ?? fallbackId;
+    const id = slugify(idSource);
+    if (id.length === 0) {
+        throw new Error("TTSR markdown rule needs an `id:` in front-matter or a non-empty fallbackId");
+    }
+    return createTTSRRule({
+        id,
+        condition: literal.source,
+        flags: literal.flags,
+        scope: fm.scope ?? "any",
+        body: fm.body,
+        ...(fm.oneShot !== undefined ? { oneShot: fm.oneShot } : {}),
+    });
+}
+/**
+ * Round-trip helper: serialise a TTSRRule back to markdown
+ * front-matter. Used by the runner for `mem_save` snapshots and
+ * by tests for parse/serialise symmetry.
+ */
+export function serializeRuleToMarkdown(rule) {
+    const flags = rule.condition.flags;
+    const source = rule.condition.source;
+    const conditionLiteral = flags ? `/${source}/${flags}` : `/${source}/`;
+    const lines = [
+        "---",
+        `id: ${rule.id}`,
+        `ttsr-condition: ${conditionLiteral}`,
+        `ttsr-scope: ${rule.scope}`,
+    ];
+    if (rule.oneShot === false) {
+        lines.push("one-shot: false");
+    }
+    lines.push("---", "", rule.body);
+    return lines.join("\n");
+}
+//# sourceMappingURL=ttsr-rule.js.map

package/dist/runtime-hooks/ttsr-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttsr-rule.js","sourceRoot":"","sources":["../../src/runtime-hooks/ttsr-rule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,gBAAgB,EAAoB,MAAM,iBAAiB,CAAC;AA0CrE;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAA2B;IACxD,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,cAAc,EAAE,8BAA8B,CAAC,CAAC;IAClE,CAAC;IAED,qEAAqE;IACrE,sEAAsE;IACtE,+DAA+D;IAC/D,IAAI,SAAiB,CAAC;IACtB,IAAI,IAAI,CAAC,SAAS,YAAY,MAAM,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrD,SAAS,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;SAAM,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,SAAS,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,cAAc,EAAE,wBAAwB,GAAG,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,cAAc,EAAE,kDAAkD,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,KAAK,GAAgB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IAC/C,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,cAAc,EAAE,gDAAgD,KAAK,GAAG,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IAErC,OAAO;QACL,EAAE;QACF,SAAS;QACT,KAAK;QACL,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC;AAwBD;;;;;GAKG;AACH,SAAS,OAAO,CAAC,CAAS;IACxB,OAAO,CAAC;SACL,WAAW,EAAE;SACb,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC;SACpC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,4DAA4D;IAC5D,MAAM,CAAC,GAAG,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,GAAG,GAA2B,EAAE,CAAC;IAEvC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACxD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,SAAS;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpD,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7F,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,MAAM,YAAY,GAChB,GAAG,CAAC,gBAAgB,CAAC;QACrB,GAAG,CAAC,gBAAgB,CAAC;QACrB,GAAG,CAAC,WAAW,CAAC;QAChB,GAAG,CAAC,cAAc,CAAC;QACnB,SAAS,CAAC;IAEZ,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;IAErF,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;IACpD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACxE,MAAM,OAAO,GACX,OAAO,UAAU,KAAK,QAAQ;QAC5B,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACjE,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,IAAI;KACL,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,UAAU,GAAG,EAAE;IACjE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACrB,IAAI,OAAO,EAAE,CAAC,SAAS,KAAK,QAAQ,IAAI,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,IAAI,UAAU,CAAC;IACrC,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IAED,OAAO,cAAc,CAAC;QACpB,EAAE;QACF,SAAS,EAAE,OAAO,CAAC,MAAM;QACzB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK;QACxB,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,GAAG,CAAC,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7D,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAc;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IACrC,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC;IACvE,MAAM,KAAK,GAAa;QACtB,KAAK;QACL,OAAO,IAAI,CAAC,EAAE,EAAE;QAChB,mBAAmB,gBAAgB,EAAE;QACrC,eAAe,IAAI,CAAC,KAAK,EAAE;KAC5B,CAAC;IACF,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAChC,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}