@gridlock/orchestrator 0.1.0 → 0.2.0

package/dist/evaluation/Deadlines.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Deadlines — wall-clock deadline definitions + pure schedule computation.
+ *
+ * Core-Configure split (same contract as EscalationClock):
+ *   - Engine provides: the typed deadline shape, schedule computation,
+ *     due-event selection, and stable fired-event keys.
+ *   - Product provides: the authored definitions (offsets, messages,
+ *     consequences), the wall-clock sweep that polls `dueDeadlineEvents`,
+ *     and the delivery/consequence wiring.
+ *
+ * Why this is NOT part of the clock loop: the escalation clock is
+ * action-cost-based — it advances only inside command processing. Real
+ * time passing with zero player actions touches nothing in the engine.
+ * Wall-clock pressure therefore lives OUTSIDE the engine loop: a host
+ * process computes the schedule once from the session's start time and
+ * polls it on its own cadence. Everything here is pure and clock-free
+ * (callers pass `nowMs`), so hosts and tests control time explicitly.
+ *
+ * Deadlines are authored as OFFSETS from session start, never absolute
+ * times — scenarios are replayable, and an absolute authored time would
+ * be stale on every run after the first.
+ */
+/** What happens when a deadline expires un-met. */
+export type DeadlineConsequence = 
+/**
+ * Burn `units` off the action-cost clock — pressure escalates through
+ * the existing phase machinery, and evaluation-time grade impact falls
+ * out of the clock state as usual. No new truth vocabulary.
+ */
+{
+    kind: 'advance-clock';
+    units: number;
+}
+/** Message-only escalation: the host delivers the expiry message, nothing mechanical changes. */
+ | {
+    kind: 'narrative-only';
+};
+/** One authored wall-clock deadline. */
+export interface DeadlineDefinition {
+    /** Unique (per scenario) deadline identifier. */
+    id: string;
+    /** Minutes after session start when the deadline expires. Must be > 0. */
+    offsetMinutes: number;
+    /**
+     * Reminder lead times, in minutes before expiry. Each must be > 0 and
+     * < offsetMinutes (a reminder scheduled at or after expiry is dropped
+     * defensively by `computeDeadlineSchedule`).
+     */
+    reminderMinutesBefore: number[];
+    /** The pressure message delivered at reminders and expiry. */
+    message: string;
+    /** What expiry does. */
+    consequence: DeadlineConsequence;
+}
+/** One concrete scheduled firing derived from a definition. */
+export interface DeadlineEvent {
+    deadlineId: string;
+    kind: 'reminder' | 'expiry';
+    /** Absolute wall-clock ms when this event is due. */
+    dueAtMs: number;
+    /** Reminder lead time (reminders only). */
+    minutesBefore?: number;
+    /** The authored message. */
+    message: string;
+    /** Present on expiry events only. */
+    consequence?: DeadlineConsequence;
+}
+/**
+ * Stable identity for a scheduled event, for at-most-once firing across
+ * host restarts: persist the keys of fired events and pass them back as
+ * `firedKeys`. Keys are derived from authored data only (never from
+ * wall-clock values), so a recomputed schedule after a restart yields
+ * identical keys.
+ */
+export declare function deadlineEventKey(event: Pick<DeadlineEvent, 'deadlineId' | 'kind' | 'minutesBefore'>): string;
+/**
+ * Expand definitions into the full firing schedule for one session,
+ * sorted by due time (ties: reminders before expiries, then definition
+ * order). Defensive drops, rather than throws, for authored data that
+ * validation should have caught: non-positive offsets drop the whole
+ * definition; reminders at/after expiry or non-positive drop that
+ * reminder; duplicate reminder lead times collapse to one.
+ */
+export declare function computeDeadlineSchedule(definitions: readonly DeadlineDefinition[], sessionStartMs: number): DeadlineEvent[];
+/**
+ * The events due at `nowMs` that have not fired yet. `firedKeys` is the
+ * host-persisted set of `deadlineEventKey` values — passing it back in
+ * makes the poll idempotent across sweeps AND restarts (the restart-safe
+ * at-most-once contract the host's durable store provides).
+ *
+ * Late events are still returned (a sweep that was down for an hour
+ * fires everything that came due meanwhile, in order) — the host decides
+ * whether stale reminders are worth sending; expiries always are.
+ */
+export declare function dueDeadlineEvents(schedule: readonly DeadlineEvent[], nowMs: number, firedKeys: ReadonlySet<string>): DeadlineEvent[];
+//# sourceMappingURL=Deadlines.d.ts.map

package/dist/evaluation/Deadlines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Deadlines.d.ts","sourceRoot":"","sources":["../../src/evaluation/Deadlines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,mDAAmD;AACnD,MAAM,MAAM,mBAAmB;AAC7B;;;;GAIG;AACD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAC1C,iGAAiG;GAC/F;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE/B,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,MAAM,GAAG,eAAe,CAAC,GAAG,MAAM,CAI5G;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,SAAS,kBAAkB,EAAE,EAC1C,cAAc,EAAE,MAAM,GACrB,aAAa,EAAE,CAmCjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,aAAa,EAAE,CAIjB"}

package/dist/evaluation/Deadlines.js

@@ -0,0 +1,94 @@
+/**
+ * Deadlines — wall-clock deadline definitions + pure schedule computation.
+ *
+ * Core-Configure split (same contract as EscalationClock):
+ *   - Engine provides: the typed deadline shape, schedule computation,
+ *     due-event selection, and stable fired-event keys.
+ *   - Product provides: the authored definitions (offsets, messages,
+ *     consequences), the wall-clock sweep that polls `dueDeadlineEvents`,
+ *     and the delivery/consequence wiring.
+ *
+ * Why this is NOT part of the clock loop: the escalation clock is
+ * action-cost-based — it advances only inside command processing. Real
+ * time passing with zero player actions touches nothing in the engine.
+ * Wall-clock pressure therefore lives OUTSIDE the engine loop: a host
+ * process computes the schedule once from the session's start time and
+ * polls it on its own cadence. Everything here is pure and clock-free
+ * (callers pass `nowMs`), so hosts and tests control time explicitly.
+ *
+ * Deadlines are authored as OFFSETS from session start, never absolute
+ * times — scenarios are replayable, and an absolute authored time would
+ * be stale on every run after the first.
+ */
+const MS_PER_MINUTE = 60_000;
+/**
+ * Stable identity for a scheduled event, for at-most-once firing across
+ * host restarts: persist the keys of fired events and pass them back as
+ * `firedKeys`. Keys are derived from authored data only (never from
+ * wall-clock values), so a recomputed schedule after a restart yields
+ * identical keys.
+ */
+export function deadlineEventKey(event) {
+    return event.kind === 'reminder'
+        ? `${event.deadlineId}:reminder:${event.minutesBefore}`
+        : `${event.deadlineId}:expiry`;
+}
+/**
+ * Expand definitions into the full firing schedule for one session,
+ * sorted by due time (ties: reminders before expiries, then definition
+ * order). Defensive drops, rather than throws, for authored data that
+ * validation should have caught: non-positive offsets drop the whole
+ * definition; reminders at/after expiry or non-positive drop that
+ * reminder; duplicate reminder lead times collapse to one.
+ */
+export function computeDeadlineSchedule(definitions, sessionStartMs) {
+    const events = [];
+    for (const def of definitions) {
+        if (!Number.isFinite(def.offsetMinutes) || def.offsetMinutes <= 0)
+            continue;
+        const expiryAtMs = sessionStartMs + def.offsetMinutes * MS_PER_MINUTE;
+        const seenLeads = new Set();
+        for (const lead of def.reminderMinutesBefore) {
+            if (!Number.isFinite(lead) || lead <= 0 || lead >= def.offsetMinutes)
+                continue;
+            if (seenLeads.has(lead))
+                continue;
+            seenLeads.add(lead);
+            events.push({
+                deadlineId: def.id,
+                kind: 'reminder',
+                dueAtMs: expiryAtMs - lead * MS_PER_MINUTE,
+                minutesBefore: lead,
+                message: def.message,
+            });
+        }
+        events.push({
+            deadlineId: def.id,
+            kind: 'expiry',
+            dueAtMs: expiryAtMs,
+            message: def.message,
+            consequence: def.consequence,
+        });
+    }
+    return events.sort((a, b) => {
+        if (a.dueAtMs !== b.dueAtMs)
+            return a.dueAtMs - b.dueAtMs;
+        if (a.kind !== b.kind)
+            return a.kind === 'reminder' ? -1 : 1;
+        return 0;
+    });
+}
+/**
+ * The events due at `nowMs` that have not fired yet. `firedKeys` is the
+ * host-persisted set of `deadlineEventKey` values — passing it back in
+ * makes the poll idempotent across sweeps AND restarts (the restart-safe
+ * at-most-once contract the host's durable store provides).
+ *
+ * Late events are still returned (a sweep that was down for an hour
+ * fires everything that came due meanwhile, in order) — the host decides
+ * whether stale reminders are worth sending; expiries always are.
+ */
+export function dueDeadlineEvents(schedule, nowMs, firedKeys) {
+    return schedule.filter((event) => event.dueAtMs <= nowMs && !firedKeys.has(deadlineEventKey(event)));
+}
+//# sourceMappingURL=Deadlines.js.map

package/dist/evaluation/Deadlines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Deadlines.js","sourceRoot":"","sources":["../../src/evaluation/Deadlines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA6CH,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAmE;IAClG,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU;QAC9B,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,aAAa,KAAK,CAAC,aAAa,EAAE;QACvD,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,SAAS,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAA0C,EAC1C,cAAsB;IAEtB,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,IAAI,CAAC;YAAE,SAAS;QAC5E,MAAM,UAAU,GAAG,cAAc,GAAG,GAAG,CAAC,aAAa,GAAG,aAAa,CAAC;QAEtE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,qBAAqB,EAAE,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC,aAAa;gBAAE,SAAS;YAC/E,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAClC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC;gBACV,UAAU,EAAE,GAAG,CAAC,EAAE;gBAClB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,aAAa;gBAC1C,aAAa,EAAE,IAAI;gBACnB,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,UAAU,EAAE,GAAG,CAAC,EAAE;YAClB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC1D,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAkC,EAClC,KAAa,EACb,SAA8B;IAE9B,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAC7E,CAAC;AACJ,CAAC"}

package/dist/evaluation/index.d.ts

@@ -5,4 +5,6 @@ export { computeModifiers } from './WorldState.js';
 export type { WorldStateModifiers } from './WorldState.js';
 export { createClock, getActionCost, advanceClock, getClockStatusLabel, isOverrun, TIC_CLOCK_CONFIG } from './EscalationClock.js';
 export type { GameClock, EscalationPhase, ClockConfig, PhaseDefinition } from './EscalationClock.js';
+export { computeDeadlineSchedule, dueDeadlineEvents, deadlineEventKey, } from './Deadlines.js';
+export type { DeadlineConsequence, DeadlineDefinition, DeadlineEvent, } from './Deadlines.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/evaluation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/evaluation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC1G,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC7G,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAClI,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/evaluation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC1G,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC7G,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAClI,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACrG,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/evaluation/index.js

@@ -1,4 +1,5 @@
 export { generatePerformanceReport, deriveGrade, TIC_EVALUATION_CONFIG } from './PerformanceEvaluator.js';
 export { computeModifiers } from './WorldState.js';
 export { createClock, getActionCost, advanceClock, getClockStatusLabel, isOverrun, TIC_CLOCK_CONFIG } from './EscalationClock.js';
+export { computeDeadlineSchedule, dueDeadlineEvents, deadlineEventKey, } from './Deadlines.js';
 //# sourceMappingURL=index.js.map

package/dist/evaluation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/evaluation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAG1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/evaluation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAG1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAElI,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/handlers/IntentInterpreter.d.ts

@@ -0,0 +1,140 @@
+/**
+ * IntentInterpreter — generic AI Assistant intent-classification primitive.
+ *
+ * An engine-level extension of the AI Assistant surface (alongside
+ * {@link AssistantCommandRegistry}). Products that host a natural-language
+ * assistant (e.g. TIC's SAGE) configure this primitive with a product-
+ * specific intent schema and a fallback regex ruleset; the engine owns
+ * the classification flow, LLM invocation, confidence threshold, and
+ * fallback ladder.
+ *
+ * Design rules:
+ * - Zero product vocabulary. The generic `TIntent` type is supplied by the
+ *   product; the engine never looks inside it.
+ * - No zod dependency. Products plug in their own validator/parser.
+ * - Fallback ladder: LLM → regex rules → product-supplied clarify intent.
+ * - LLM output under the confidence threshold is treated as a failed
+ *   classification and falls through to regex.
+ */
+import type { LLMAdapter } from '../types.js';
+/**
+ * Read-only context passed into every classification call. Engine-generic:
+ * just a roster of addressable entities (NPCs in TIC, whatever the product
+ * calls them) plus the last-addressed id for target inference.
+ */
+export interface IntentContext {
+    /** Entities the player can address. Engine uses `id` + `displayName`/`aliases` for target resolution. */
+    readonly roster: ReadonlyArray<IntentRosterEntry>;
+    /** The most-recently-addressed entity id, or null. Used to infer targets for pronoun-style input ("push back on him"). */
+    readonly lastAddressedId: string | null;
+    /** Command names available to the assistant (surfaced in the prompt so the LLM sees the vocabulary). */
+    readonly availableCommands: ReadonlyArray<string>;
+    /** Optional tone/register hint for the prompt (e.g. 'noir', 'procedural'). */
+    readonly registerHint?: string;
+}
+export interface IntentRosterEntry {
+    readonly id: string;
+    readonly displayName: string;
+    readonly aliases?: ReadonlyArray<string>;
+}
+export type IntentSource = 'llm' | 'regex' | 'clarify';
+export interface ClassifiedIntent<TIntent> {
+    readonly intent: TIntent;
+    /** 0..1. LLM classifiers produce a real confidence; regex rules default to 0.6 unless set. */
+    readonly confidence: number;
+    /** Which branch of the ladder produced the result. */
+    readonly source: IntentSource;
+}
+/**
+ * A regex rule in the fallback ladder. Rules are evaluated in order; the
+ * first match wins. `build` converts the match into the product's intent
+ * shape.
+ */
+export interface RegexIntentRule<TIntent> {
+    readonly pattern: RegExp;
+    readonly build: (match: RegExpMatchArray, input: string, ctx: IntentContext) => TIntent;
+    /** Confidence emitted when this rule fires. Defaults to 0.6. */
+    readonly confidence?: number;
+}
+/**
+ * Parsed LLM classification result before confidence gating. Products
+ * implement `parseLlmResponse` to turn raw LLM text into this shape.
+ * Return `null` when the response is malformed or not parseable.
+ */
+export interface ParsedLlmClassification<TIntent> {
+    readonly intent: TIntent;
+    /** 0..1 confidence the LLM self-reports. */
+    readonly confidence: number;
+}
+export interface IntentInterpreterOptions<TIntent> {
+    /**
+     * Build the LLM prompt string from the raw input + context. Product owns
+     * tone, schema description, and JSON-shape instructions.
+     */
+    readonly buildPrompt: (input: string, ctx: IntentContext) => string;
+    /**
+     * Parse raw LLM response text into a classification. Return null on
+     * malformed output; the interpreter falls through to regex.
+     */
+    readonly parseLlmResponse: (raw: string) => ParsedLlmClassification<TIntent> | null;
+    /**
+     * Ordered regex fallback rules. Evaluated after LLM failure / low
+     * confidence. First match wins.
+     */
+    readonly regexRules: ReadonlyArray<RegexIntentRule<TIntent>>;
+    /**
+     * Product constructor for the "I didn't understand, please clarify"
+     * intent. Invoked when no rule matches and the LLM is unavailable or
+     * failed. `reason` is a short machine-readable tag for telemetry.
+     */
+    readonly buildClarifyIntent: (reason: ClarifyReason, input: string, ctx: IntentContext) => TIntent;
+    /**
+     * Optional LLM adapter. When absent, the interpreter skips the LLM
+     * branch and goes straight to regex.
+     */
+    readonly llmAdapter?: LLMAdapter;
+    /**
+     * Confidence threshold below which LLM results are discarded and the
+     * regex ladder runs instead. Defaults to {@link DEFAULT_MIN_CONFIDENCE}.
+     */
+    readonly minConfidence?: number;
+    /**
+     * Optional agent definition / merged persona passed through to the LLM
+     * adapter's `execute` call. Products that wire through the full
+     * agent-orchestrator pipeline pass these; simple products can omit
+     * them (the adapter receives empty records).
+     */
+    readonly agentDefinition?: Record<string, unknown>;
+    readonly mergedPersona?: Record<string, unknown>;
+}
+/** Short tags for the {@link IntentInterpreterOptions.buildClarifyIntent} `reason` parameter. */
+export type ClarifyReason = 'llm-unavailable' | 'llm-parse-failed' | 'llm-low-confidence' | 'llm-threw' | 'regex-no-match';
+/** Fixed confidence threshold per the stack plan (#1263 generalisation). */
+export declare const DEFAULT_MIN_CONFIDENCE = 0.7;
+/** Default confidence emitted by regex-matched rules. */
+export declare const DEFAULT_REGEX_CONFIDENCE = 0.6;
+/**
+ * Engine-level intent interpreter. Instantiated once per product-specific
+ * assistant (TIC's SAGE, Gridlock's game-agnostic advisor, etc.) and reused
+ * across calls.
+ */
+export declare class IntentInterpreter<TIntent> {
+    private readonly opts;
+    private readonly minConfidence;
+    constructor(opts: IntentInterpreterOptions<TIntent>);
+    /**
+     * Classify `input` against the product's intent schema. Runs the
+     * fallback ladder:
+     *
+     *   1. If an LLM adapter is configured, prompt it and parse the response.
+     *      - Parse failure → fall to step 2.
+     *      - Confidence >= threshold → return (source: 'llm').
+     *      - Confidence < threshold → fall to step 2.
+     *   2. Walk regex rules in order. First match → return (source: 'regex').
+     *   3. No match → return the product-supplied clarify intent (source: 'clarify').
+     */
+    interpret(input: string, ctx: IntentContext): Promise<ClassifiedIntent<TIntent>>;
+    private tryLlm;
+    private tryRegex;
+}
+//# sourceMappingURL=IntentInterpreter.d.ts.map

package/dist/handlers/IntentInterpreter.d.ts.map

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

package/dist/handlers/IntentInterpreter.js

@@ -0,0 +1,90 @@
+// @engine — Generic NL-to-intent interpreter primitive. No product vocabulary;
+// products supply the intent shape, prompt template, response parser, and
+// regex fallback rules.
+/** Fixed confidence threshold per the stack plan (#1263 generalisation). */
+export const DEFAULT_MIN_CONFIDENCE = 0.7;
+/** Default confidence emitted by regex-matched rules. */
+export const DEFAULT_REGEX_CONFIDENCE = 0.6;
+// ---------------------------------------------------------------------------
+// Interpreter
+// ---------------------------------------------------------------------------
+/**
+ * Engine-level intent interpreter. Instantiated once per product-specific
+ * assistant (TIC's SAGE, Gridlock's game-agnostic advisor, etc.) and reused
+ * across calls.
+ */
+export class IntentInterpreter {
+    opts;
+    minConfidence;
+    constructor(opts) {
+        this.opts = opts;
+        this.minConfidence = opts.minConfidence ?? DEFAULT_MIN_CONFIDENCE;
+    }
+    /**
+     * Classify `input` against the product's intent schema. Runs the
+     * fallback ladder:
+     *
+     *   1. If an LLM adapter is configured, prompt it and parse the response.
+     *      - Parse failure → fall to step 2.
+     *      - Confidence >= threshold → return (source: 'llm').
+     *      - Confidence < threshold → fall to step 2.
+     *   2. Walk regex rules in order. First match → return (source: 'regex').
+     *   3. No match → return the product-supplied clarify intent (source: 'clarify').
+     */
+    async interpret(input, ctx) {
+        if (this.opts.llmAdapter) {
+            const llmResult = await this.tryLlm(input, ctx);
+            if (llmResult)
+                return llmResult;
+        }
+        const regexResult = this.tryRegex(input, ctx);
+        if (regexResult)
+            return regexResult;
+        return {
+            intent: this.opts.buildClarifyIntent(this.opts.llmAdapter ? 'regex-no-match' : 'llm-unavailable', input, ctx),
+            confidence: 0,
+            source: 'clarify',
+        };
+    }
+    async tryLlm(input, ctx) {
+        const prompt = this.opts.buildPrompt(input, ctx);
+        let raw;
+        try {
+            const result = await this.opts.llmAdapter.execute({
+                contextPackage: { input, prompt, roster: ctx.roster, lastAddressedId: ctx.lastAddressedId },
+                agentDefinition: this.opts.agentDefinition ?? {},
+                mergedPersona: this.opts.mergedPersona ?? {},
+            });
+            raw = result.responseText;
+        }
+        catch {
+            // LLM threw — fall through to regex. Clarify reason captured if
+            // the ladder exhausts.
+            return null;
+        }
+        const parsed = this.opts.parseLlmResponse(raw);
+        if (!parsed)
+            return null;
+        if (parsed.confidence < this.minConfidence)
+            return null;
+        return {
+            intent: parsed.intent,
+            confidence: parsed.confidence,
+            source: 'llm',
+        };
+    }
+    tryRegex(input, ctx) {
+        for (const rule of this.opts.regexRules) {
+            const match = input.match(rule.pattern);
+            if (match) {
+                return {
+                    intent: rule.build(match, input, ctx),
+                    confidence: rule.confidence ?? DEFAULT_REGEX_CONFIDENCE,
+                    source: 'regex',
+                };
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=IntentInterpreter.js.map

package/dist/handlers/IntentInterpreter.js.map

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

package/dist/index.d.ts

@@ -39,10 +39,20 @@ export { EvidenceGraph } from './EvidenceGraph.js';
 export { getEntityKnowledgeView } from './KnowledgeBoundary.js';
 export type { EntityKnowledgeView, AuthoredKnowledge, EntityFact, KnowledgeDisclosure, KnowledgeBoundaryInput, } from './KnowledgeBoundary.js';
 export { DisclosureEngine } from './DisclosureEngine.js';
+export { isReleaseConditionMet, matchTopics, deriveTopicsFromLabel, } from './ReleaseConditions.js';
+export type { ReleaseContext } from './ReleaseConditions.js';
 export type { VisibilityState, VisibilityTransition, RevealTrigger, RevealInstruction, DisclosureEngineConfig, TransitionNotifier, DisclosureSnapshot, } from './DisclosureEngine.js';
 export { evaluateInteraction, getSensitivityMultiplier, buildRiceProfile, UNBLOCK_BASELINE, MAX_PER_ACTION_GAIN, RICE_BASE_GAINS, } from './InteractionEvaluator.js';
 export type { CharacterRiceProfile, InteractionResult, } from './InteractionEvaluator.js';
+export { applyInteractionSeed } from './InteractionSeed.js';
+export type { InteractionSeed } from './InteractionSeed.js';
+export { InMemoryPlayerTurnLog } from './PlayerTurnLog.js';
+export type { PlayerTurnLog, PlayerTurnEntry, PlayerTurnEntryInput, } from './PlayerTurnLog.js';
+export { InMemoryInventoryLedger } from './InventoryLedger.js';
+export type { InventoryLedger } from './InventoryLedger.js';
 export { AssistantCommandRegistry, type AssistantCommand, type CommandTier, } from './handlers/AssistantCommandRegistry.js';
+export { IntentInterpreter, DEFAULT_MIN_CONFIDENCE, DEFAULT_REGEX_CONFIDENCE, } from './handlers/IntentInterpreter.js';
+export type { IntentContext, IntentRosterEntry, IntentSource, ClassifiedIntent, RegexIntentRule, ParsedLlmClassification, IntentInterpreterOptions, ClarifyReason, } from './handlers/IntentInterpreter.js';
 export * from './handlers/ResolutionGate.js';
 export * from './handlers/GameLifecycle.js';
 export { SourceTypeRegistry, sourceTypeRegistry, ingestFinding, } from './handlers/EvidenceIngestion.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGtF,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,wCAAwC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,cAAc,uBAAuB,CAAC;AAGtC,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGtF,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EACV,aAAa,EACb,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EACL,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,aAAa,GACd,MAAM,iCAAiC,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,cAAc,uBAAuB,CAAC;AAGtC,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -39,10 +39,21 @@ export * from './AgentRoute.js';
 export { EvidenceGraph } from './EvidenceGraph.js';
 export { getEntityKnowledgeView } from './KnowledgeBoundary.js';
 export { DisclosureEngine } from './DisclosureEngine.js';
+export { isReleaseConditionMet, matchTopics, deriveTopicsFromLabel, } from './ReleaseConditions.js';
 // RICE interaction evaluator (step 5.3)
 export { evaluateInteraction, getSensitivityMultiplier, buildRiceProfile, UNBLOCK_BASELINE, MAX_PER_ACTION_GAIN, RICE_BASE_GAINS, } from './InteractionEvaluator.js';
+// Interaction-state seed (Core-Configure seam for inter-case relationship state)
+export { applyInteractionSeed } from './InteractionSeed.js';
+// Per-session player-turn log (engine-generic capture seam for post-case
+// craft scoring — TIC's Tradecraft Trainer is the first consumer)
+export { InMemoryPlayerTurnLog } from './PlayerTurnLog.js';
+// Per-player item inventory (engine-generic backing for the RICE-aligned
+// `/gift` flow + #1874's `@gridlock/economy` `InventoryStore` shape).
+// MS-27b #1872.
+export { InMemoryInventoryLedger } from './InventoryLedger.js';
 // Engine handlers (step 5.4, 5.8)
 export { AssistantCommandRegistry, } from './handlers/AssistantCommandRegistry.js';
+export { IntentInterpreter, DEFAULT_MIN_CONFIDENCE, DEFAULT_REGEX_CONFIDENCE, } from './handlers/IntentInterpreter.js';
 export * from './handlers/ResolutionGate.js';
 export * from './handlers/GameLifecycle.js';
 export { SourceTypeRegistry, sourceTypeRegistry, ingestFinding, } from './handlers/EvidenceIngestion.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AA0BH,kDAAkD;AAClD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElE,mDAAmD;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,2CAA2C;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAQhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAWzD,wCAAwC;AACxC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAMnC,kCAAkC;AAClC,OAAO,EACL,wBAAwB,GAGzB,MAAM,wCAAwC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,iCAAiC,CAAC;AAKzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,mCAAmC;AACnC,cAAc,uBAAuB,CAAC;AAEtC,kDAAkD;AAClD,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AA0BH,kDAAkD;AAClD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElE,mDAAmD;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,2CAA2C;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAQhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAYhC,wCAAwC;AACxC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAMnC,iFAAiF;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D,yEAAyE;AACzE,kEAAkE;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAO3D,yEAAyE;AACzE,sEAAsE;AACtE,gBAAgB;AAChB,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,kCAAkC;AAClC,OAAO,EACL,wBAAwB,GAGzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAWzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,iCAAiC,CAAC;AAKzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,mCAAmC;AACnC,cAAc,uBAAuB,CAAC;AAEtC,kDAAkD;AAClD,cAAc,0BAA0B,CAAC"}

package/dist/types.d.ts

@@ -43,6 +43,14 @@ export interface InteractionSignal {
     intensity: number;
     targetCharacterId: string;
     timestamp: number;
+    /**
+     * Optional RICE-dimension override for item-aware gift signals
+     * (#1872, MS-27b). When `subtype === 'item_gift'`, the evaluator
+     * routes the gain to this dimension instead of the default
+     * `'incentive'` so a `riceDimension: 'ego'` shop-item produces an
+     * ego boost, etc. Other subtypes ignore this field.
+     */
+    riceDimensionOverride?: keyof RiceProgress;
 }
 /**
  * Per-dimension RICE progress scores (0–10).
@@ -134,8 +142,43 @@ export interface NarrativeDispatchHookInput {
     caseId?: string;
     recipientPlayerId: string;
 }
+/**
+ * Engine-emitted typed event kinds (#1201, MS-25d). Names are engine-neutral;
+ * typed payload shapes live in product-layer packages. The engine itself
+ * passes `Record<string, unknown>` and the hook narrows.
+ */
+export type NarrativeEventKind = 'sage.analysis' | 'investigation.findings' | 'investigation.fact-recorded' | 'clock.pressure' | 'milestone.progress' | 'resolution.report';
+export interface NarrativeDispatchContext {
+    recipientPlayerId: string;
+    caseId?: string;
+    sourceCharacterId?: string | null;
+    sourceCharacterTier?: string;
+}
+/**
+ * Delivery receipt returned by a NarrativeDispatchHook (#1211, MS-25d).
+ *
+ *   - `delivered` — transport accepted the message.
+ *   - `deferred`  — transient failure the adapter expects to recover from.
+ *   - `failed`    — permanent delivery failure; no retry will succeed.
+ */
+export interface DeliveryReceipt {
+    status: 'delivered' | 'deferred' | 'failed';
+    providerMessageId?: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export type DispatchReturn = void | DeliveryReceipt | Promise<DeliveryReceipt | void>;
 export interface NarrativeDispatchHook {
-    onCharacterDialogue(input: NarrativeDispatchHookInput): void;
+    onCharacterDialogue(input: NarrativeDispatchHookInput): DispatchReturn;
+    /**
+     * Generic typed-event dispatch (#1201). Optional — implementations that
+     * only handle dialogue may omit this method. Callers MUST treat absence
+     * as a no-op. Implementations MUST NOT throw. A returned Promise is
+     * captured without awaiting on the hot path (#1211).
+     */
+    dispatch?(kind: NarrativeEventKind | string, payload: Record<string, unknown>, ctx: NarrativeDispatchContext): DispatchReturn;
 }
 /**
  * ScenarioLoader — abstraction for loading and parsing scenario data.
@@ -258,6 +301,19 @@ export interface EngineState {
     /** Findings produced by the evidence pipeline (facts → validators → findings). */
     findings: import('@gridlock/validators').Finding[];
     /** Core evidence graph structure. */
+    /**
+     * The authored case graph (#2395, Phase 0 of the progress unlock graph).
+     * Seeded verbatim from the scenario's evidenceGraph at load and treated
+     * as read-only world truth: unlock edges are evaluated against it, and
+     * NPC visibility BFS traverses it. Never mutated at runtime.
+     */
+    authoredGraph: import('./EvidenceGraph.js').EvidenceGraph;
+    /**
+     * The player-discovered graph (#2395). Starts EMPTY at load — runtime
+     * population (talk / examine / findings) writes here. Player-facing
+     * views (graph command, DiscoveryLayer) read this, so authored-but-
+     * unreached content can no longer leak at turn 0.
+     */
     discoveredGraph: import('./EvidenceGraph.js').EvidenceGraph;
     /** Objective evidence store (core truth layer). */
     factLedger: import('./investigation/FactLedger.js').FactLedger;
@@ -279,5 +335,28 @@ export interface EngineState {
     lastPerformanceReport?: import('./evaluation/index.js').PerformanceReport;
     /** World-state modifiers from evaluation. */
     appliedModifiers?: import('./evaluation/index.js').WorldStateModifiers;
+    /**
+     * Delivery receipts for outbound narrative dispatch (#1211, MS-25d).
+     *
+     * Populated asynchronously by the Orchestrator when a NarrativeDispatchHook
+     * returns (or resolves to) a DeliveryReceipt. Writes happen after the
+     * command return path so the hot path is never blocked. Consumers (notes,
+     * casefile, debug views) read this to annotate failed/deferred deliveries.
+     */
+    deliveryReceipts: DeliveryReceiptRecord[];
+}
+/**
+ * One observed dispatch outcome (#1211). Captured whether or not delivery
+ * succeeded; failures and deferrals surface to the player in notes/casefile.
+ */
+export interface DeliveryReceiptRecord {
+    /** Engine event kind — 'dialogue.response' for character dialogue, or a NarrativeEventKind. */
+    kind: string;
+    /** Engine-side target identifier: characterId for dialogue, sourceCharacterId for typed events, or null for system-sourced events. */
+    targetId: string | null;
+    /** The dispatch receipt. */
+    receipt: DeliveryReceipt;
+    /** Wall-clock time when the receipt was recorded. */
+    recordedAt: Date;
 }
 //# sourceMappingURL=types.d.ts.map