usesteady 0.1.0-alpha.1

package/dist/src/present/present-coordinator.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Present Coordinator — Phase 5, Present Layer integration path.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * A single consumer entry point that:
+ *   1. Tries reminder presentation if the raw input has a reminder signal.
+ *   2. Falls back to standard intake presentation if no reminder signal is found.
+ *
+ * Consumers receive a PresentResult discriminated union and route based on kind.
+ * The coordinator owns selection. The consumer owns rendering and routing.
+ *
+ * ── Why a coordinator? ────────────────────────────────────────────────────────
+ *
+ * The existing formatIntakeResult receives only IntakeResult — it does not see
+ * the raw input. Reminder detection requires the raw input (explicit signal
+ * matching). The coordinator is the narrow bridge that wires both without
+ * mixing their concerns.
+ *
+ * ── What this is NOT ─────────────────────────────────────────────────────────
+ *
+ *   NOT an execution layer        — never schedules, stores, or triggers
+ *   NOT an intake modification    — the intake pipeline result is used as-is
+ *   NOT a decision authority      — all decisions came from upstream (intake)
+ *   NOT an interpreter            — no new classification happens here
+ *
+ * ── Routing contract ─────────────────────────────────────────────────────────
+ *
+ *   Consumer calls presentFromInput(input, intakeResult, trace?).
+ *   Consumer receives PresentResult.
+ *   Consumer checks result.kind to route:
+ *
+ *     "reminder" → render with renderReminder(), check actions[].enabled
+ *     "intake"   → render with existing PresentationOutput fields
+ *
+ *   Routing logic lives in the consumer, not here.
+ *
+ * ── Priority rule ─────────────────────────────────────────────────────────────
+ *
+ *   If the input contains a reminder signal → return kind: "reminder".
+ *   Otherwise → return kind: "intake".
+ *
+ *   This priority is intentional:
+ *   - Reminder signal is explicit ("remind me", "set a reminder", etc.)
+ *   - If the signal is present, reminder shaping is always more useful than
+ *     a generic guide/execute presentation.
+ *   - The intake result is still available inside PresentResult for consumers
+ *     who need it alongside the reminder presentation.
+ *
+ * ── Future-safety ─────────────────────────────────────────────────────────────
+ *
+ *   When real reminder execution exists, consumers update their routing:
+ *     On confirm (enabled) → call execution layer.
+ *   The Present Layer itself never changes for that.
+ *   PresentResult remains correct.
+ */
+import type { IntakeResult } from "../intake/types.js";
+import type { DebugTrace } from "../intake/trace.js";
+import type { PresentationOutput } from "./types.js";
+import type { ReminderPresentation } from "./reminders/reminder-types.js";
+/**
+ * Minimal policy information needed for 5D cross-layer contradiction detection.
+ * Callers pass this when they have policy context available.
+ */
+export type PolicyHint = {
+    readonly prohibitedGlobs: readonly string[];
+};
+/**
+ * Minimal parsed-change shape needed for 5D target-path checks.
+ */
+export type ParsedChangeHint = {
+    readonly filePath?: string;
+};
+/**
+ * PresentResult — what presentFromInput() returns.
+ *
+ * Discriminate on `kind`:
+ *
+ *   "reminder" — input contained a reminder signal.
+ *                presentation is a ReminderPresentation.
+ *                Check presentation.state for completeness.
+ *                Check presentation.actions[].enabled before routing confirm.
+ *                intakeResult is included for consumers who need both.
+ *
+ *   "intake"   — no reminder signal found, or reminder detection returned null.
+ *                presentation is a standard PresentationOutput from formatIntakeResult.
+ *                Existing rendering logic applies.
+ */
+export type PresentResult = {
+    readonly kind: "reminder";
+    readonly presentation: ReminderPresentation;
+    readonly intakeResult: IntakeResult;
+    readonly trace?: DebugTrace;
+} | {
+    readonly kind: "intake";
+    readonly presentation: PresentationOutput;
+    readonly intakeResult: IntakeResult;
+    readonly trace?: DebugTrace;
+};
+/**
+ * Present the result of running an intake pipeline on the given input.
+ *
+ * @param input        The raw input string (same one that was passed to intake).
+ * @param intakeResult The result of runIntake / runIntakeWithTrace.
+ * @param trace        Optional debug trace from runIntakeWithTrace.
+ *
+ * Returns a PresentResult discriminated union.
+ *
+ * ── Selection logic ──────────────────────────────────────────────────────────
+ *
+ *   1. Try presentReminder(input).
+ *      If non-null → return { kind: "reminder", presentation }.
+ *   2. Otherwise → return { kind: "intake", presentation: formatIntakeResult(...) }.
+ *
+ * ── What consumers do with it ────────────────────────────────────────────────
+ *
+ *   if (result.kind === "reminder") {
+ *     // Use result.presentation (ReminderPresentation)
+ *     const rendered = renderReminder(result.presentation);
+ *     // Check result.presentation.actions.find(a => a.id === "confirm")?.enabled
+ *     // Show rendered.prompt when state !== "ready_to_confirm"
+ *   } else {
+ *     // Use result.presentation (PresentationOutput)
+ *     // Existing rendering path
+ *   }
+ *
+ * ── Determinism guarantee ────────────────────────────────────────────────────
+ *
+ *   Same inputs → same output, always.
+ *   No session state. No side effects. No randomness.
+ */
+export declare function presentFromInput(input: string, intakeResult: IntakeResult, trace?: DebugTrace, policy?: PolicyHint, parsedChange?: ParsedChangeHint): PresentResult;
+/**
+ * Returns true if the reminder presentation is complete and confirmable.
+ *
+ * Consumers should use this before showing a confirm button as active.
+ * If false, the confirm action's enabled flag will also be false —
+ * but this helper makes the check explicit and readable.
+ *
+ * Zero authority: this function never changes what will happen.
+ * It only describes the current presentation state.
+ */
+export declare function isReminderConfirmable(result: PresentResult): boolean;
+/**
+ * Returns the clarification prompt for the current reminder state, or null.
+ *
+ * Useful when consumers want to display a contextual question to the user
+ * without importing and calling renderReminder themselves.
+ *
+ * Returns null for non-reminder results and for ready_to_confirm (no prompt needed).
+ */
+export declare function getReminderPrompt(result: PresentResult): string | null;
+//# sourceMappingURL=present-coordinator.d.ts.map

package/dist/src/present/present-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"present-coordinator.d.ts","sourceRoot":"","sources":["../../../src/present/present-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAQ,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAe1E;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAMF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,IAAI,EAAU,UAAU,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAQ,UAAU,CAAC;CACnC,GACD;IACE,QAAQ,CAAC,IAAI,EAAU,QAAQ,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAQ,UAAU,CAAC;CACnC,CAAC;AAMN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAU,MAAM,EACrB,YAAY,EAAG,YAAY,EAC3B,KAAK,CAAC,EAAS,UAAU,EACzB,MAAM,CAAC,EAAQ,UAAU,EACzB,YAAY,CAAC,EAAE,gBAAgB,GAC9B,aAAa,CA8Df;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAKpE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAgBtE"}

package/dist/src/present/present-coordinator.js

@@ -0,0 +1,213 @@
+/**
+ * Present Coordinator — Phase 5, Present Layer integration path.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * A single consumer entry point that:
+ *   1. Tries reminder presentation if the raw input has a reminder signal.
+ *   2. Falls back to standard intake presentation if no reminder signal is found.
+ *
+ * Consumers receive a PresentResult discriminated union and route based on kind.
+ * The coordinator owns selection. The consumer owns rendering and routing.
+ *
+ * ── Why a coordinator? ────────────────────────────────────────────────────────
+ *
+ * The existing formatIntakeResult receives only IntakeResult — it does not see
+ * the raw input. Reminder detection requires the raw input (explicit signal
+ * matching). The coordinator is the narrow bridge that wires both without
+ * mixing their concerns.
+ *
+ * ── What this is NOT ─────────────────────────────────────────────────────────
+ *
+ *   NOT an execution layer        — never schedules, stores, or triggers
+ *   NOT an intake modification    — the intake pipeline result is used as-is
+ *   NOT a decision authority      — all decisions came from upstream (intake)
+ *   NOT an interpreter            — no new classification happens here
+ *
+ * ── Routing contract ─────────────────────────────────────────────────────────
+ *
+ *   Consumer calls presentFromInput(input, intakeResult, trace?).
+ *   Consumer receives PresentResult.
+ *   Consumer checks result.kind to route:
+ *
+ *     "reminder" → render with renderReminder(), check actions[].enabled
+ *     "intake"   → render with existing PresentationOutput fields
+ *
+ *   Routing logic lives in the consumer, not here.
+ *
+ * ── Priority rule ─────────────────────────────────────────────────────────────
+ *
+ *   If the input contains a reminder signal → return kind: "reminder".
+ *   Otherwise → return kind: "intake".
+ *
+ *   This priority is intentional:
+ *   - Reminder signal is explicit ("remind me", "set a reminder", etc.)
+ *   - If the signal is present, reminder shaping is always more useful than
+ *     a generic guide/execute presentation.
+ *   - The intake result is still available inside PresentResult for consumers
+ *     who need it alongside the reminder presentation.
+ *
+ * ── Future-safety ─────────────────────────────────────────────────────────────
+ *
+ *   When real reminder execution exists, consumers update their routing:
+ *     On confirm (enabled) → call execution layer.
+ *   The Present Layer itself never changes for that.
+ *   PresentResult remains correct.
+ */
+import { formatIntakeResult } from "./format.js";
+import { presentReminder } from "./reminders/reminder-presenter.js";
+import { evaluateControlVisibility, assertControlVisibilityConsistency, } from "./control-visibility/index.js";
+import { detectBoundaryExplanation, detectReminderBoundaryExplanation, } from "./boundary-explanation/index.js";
+import { matchesGlob } from "../cursor/glob-matcher.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// presentFromInput — the single consumer entry point
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Present the result of running an intake pipeline on the given input.
+ *
+ * @param input        The raw input string (same one that was passed to intake).
+ * @param intakeResult The result of runIntake / runIntakeWithTrace.
+ * @param trace        Optional debug trace from runIntakeWithTrace.
+ *
+ * Returns a PresentResult discriminated union.
+ *
+ * ── Selection logic ──────────────────────────────────────────────────────────
+ *
+ *   1. Try presentReminder(input).
+ *      If non-null → return { kind: "reminder", presentation }.
+ *   2. Otherwise → return { kind: "intake", presentation: formatIntakeResult(...) }.
+ *
+ * ── What consumers do with it ────────────────────────────────────────────────
+ *
+ *   if (result.kind === "reminder") {
+ *     // Use result.presentation (ReminderPresentation)
+ *     const rendered = renderReminder(result.presentation);
+ *     // Check result.presentation.actions.find(a => a.id === "confirm")?.enabled
+ *     // Show rendered.prompt when state !== "ready_to_confirm"
+ *   } else {
+ *     // Use result.presentation (PresentationOutput)
+ *     // Existing rendering path
+ *   }
+ *
+ * ── Determinism guarantee ────────────────────────────────────────────────────
+ *
+ *   Same inputs → same output, always.
+ *   No session state. No side effects. No randomness.
+ */
+export function presentFromInput(input, intakeResult, trace, policy, parsedChange) {
+    const traceField = trace !== undefined ? { trace } : {};
+    // ── Try reminder presentation first ───────────────────────────────────────
+    const reminderPresentation = presentReminder(input);
+    if (reminderPresentation !== null) {
+        // 5C: attach boundary explanation for reminder path
+        const reminderBoundary = detectReminderBoundaryExplanation(reminderPresentation);
+        const enrichedReminder = reminderBoundary
+            ? { ...reminderPresentation, boundaryExplanation: reminderBoundary }
+            : reminderPresentation;
+        // CVG read-only hook — compute and assert, output shape unchanged.
+        const cvg = evaluateControlVisibility({
+            kind: "reminder_presentation",
+            presentation: enrichedReminder,
+        });
+        assertControlVisibilityConsistency(cvg);
+        return {
+            kind: "reminder",
+            presentation: enrichedReminder,
+            intakeResult,
+            ...traceField,
+        };
+    }
+    // ── Fall back to standard intake presentation ─────────────────────────────
+    const basePresentation = formatIntakeResult(intakeResult, trace);
+    // 5C: detect boundary explanation (first-match-wins)
+    let intakeBoundary = detectBoundaryExplanation(input, intakeResult, trace);
+    // 5D: cross-layer contradiction detection (only when policy + parsedChange provided)
+    const hasContradiction = detectContradiction(intakeResult, policy, parsedChange);
+    if (hasContradiction) {
+        // policy_may_block_target overrides 5C boundary when 5D fires
+        intakeBoundary = {
+            code: "policy_may_block_target",
+            message: "This change is structurally executable, but the target file may be restricted by policy. Review the target before approving.",
+        };
+    }
+    // Attach boundary explanation when detected
+    const intakePresentation = intakeBoundary
+        ? { ...basePresentation, boundaryExplanation: intakeBoundary }
+        : basePresentation;
+    // CVG read-only hook — use provisionally_executable arm when contradiction detected
+    const cvgInput = hasContradiction
+        ? { kind: "intake_provisionally_executable", presentation: intakePresentation }
+        : { kind: "intake_presentation", presentation: intakePresentation };
+    const cvg = evaluateControlVisibility(cvgInput);
+    assertControlVisibilityConsistency(cvg);
+    return {
+        kind: "intake",
+        presentation: intakePresentation,
+        intakeResult,
+        ...traceField,
+    };
+}
+// ─── 5D contradiction detection ──────────────────────────────────────────────
+/**
+ * Returns true when the intake result is "execute" but the parsedChange.filePath
+ * matches a prohibited glob in the policy — indicating a likely downstream gate block.
+ *
+ * Pure function. No side effects. No external calls.
+ * Only runs when both policy and parsedChange are provided.
+ */
+function detectContradiction(intakeResult, policy, parsedChange) {
+    if (!policy || !parsedChange)
+        return false;
+    if (intakeResult.mode !== "execute")
+        return false;
+    const filePath = parsedChange.filePath;
+    if (!filePath)
+        return false;
+    return policy.prohibitedGlobs.some(glob => matchesGlob(filePath, glob));
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Consumer routing helpers — zero-authority, purely derived
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Returns true if the reminder presentation is complete and confirmable.
+ *
+ * Consumers should use this before showing a confirm button as active.
+ * If false, the confirm action's enabled flag will also be false —
+ * but this helper makes the check explicit and readable.
+ *
+ * Zero authority: this function never changes what will happen.
+ * It only describes the current presentation state.
+ */
+export function isReminderConfirmable(result) {
+    return (result.kind === "reminder" &&
+        result.presentation.state === "ready_to_confirm");
+}
+/**
+ * Returns the clarification prompt for the current reminder state, or null.
+ *
+ * Useful when consumers want to display a contextual question to the user
+ * without importing and calling renderReminder themselves.
+ *
+ * Returns null for non-reminder results and for ready_to_confirm (no prompt needed).
+ */
+export function getReminderPrompt(result) {
+    if (result.kind !== "reminder")
+        return null;
+    const { state, subject, time_text } = result.presentation;
+    if (state === "ready_to_confirm")
+        return null;
+    if (state === "needs_time")
+        return "When should this reminder trigger?";
+    if (state === "needs_subject")
+        return "What should this reminder be for?";
+    // ambiguous
+    // Preserve the ambiguity honestly — don't overclaim what's missing
+    const hasSubject = subject !== null;
+    const hasTime = time_text !== null;
+    if (hasSubject && !hasTime)
+        return "When should this reminder trigger?";
+    if (hasTime && !hasSubject)
+        return "What should this reminder be for?";
+    return "Is this a reminder? If so, what would you like to be reminded about, and when?";
+}
+//# sourceMappingURL=present-coordinator.js.map

package/dist/src/present/present-coordinator.js.map

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

package/dist/src/present/reminders/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Reminder presentation module — Phase 5, Present Layer.
+ *
+ * Public exports for the reminder presentation slice.
+ *
+ * Usage:
+ *   import { presentReminder, renderReminder } from "./reminders/index.js";
+ *
+ *   const presentation = presentReminder(rawInput);
+ *   if (presentation) {
+ *     const rendered = renderReminder(presentation);
+ *     // render rendered.headline, rendered.body, rendered.prompt, rendered.actions_label
+ *   }
+ *
+ * extractReminderCandidate is NOT exported here.
+ * It is exported directly from reminder-presenter.ts for testing purposes only.
+ */
+export type { ReminderPresentationState, ReminderConfidence, PresentAction, ReminderPresentation, } from "./reminder-types.js";
+export type { RenderedReminder } from "./reminder-renderer.js";
+export { presentReminder } from "./reminder-presenter.js";
+export { renderReminder } from "./reminder-renderer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/present/reminders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/present/reminders/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,YAAY,EACV,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/present/reminders/index.js

@@ -0,0 +1,22 @@
+/**
+ * Reminder presentation module — Phase 5, Present Layer.
+ *
+ * Public exports for the reminder presentation slice.
+ *
+ * Usage:
+ *   import { presentReminder, renderReminder } from "./reminders/index.js";
+ *
+ *   const presentation = presentReminder(rawInput);
+ *   if (presentation) {
+ *     const rendered = renderReminder(presentation);
+ *     // render rendered.headline, rendered.body, rendered.prompt, rendered.actions_label
+ *   }
+ *
+ * extractReminderCandidate is NOT exported here.
+ * It is exported directly from reminder-presenter.ts for testing purposes only.
+ */
+// Presenter (raw input → structured presentation)
+export { presentReminder } from "./reminder-presenter.js";
+// Renderer (structured presentation → display strings)
+export { renderReminder } from "./reminder-renderer.js";
+//# sourceMappingURL=index.js.map

package/dist/src/present/reminders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/present/reminders/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH,kDAAkD;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,uDAAuD;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/present/reminders/reminder-presenter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Reminder Presenter — Phase 5, Present Layer.
+ *
+ * ── Responsibility ────────────────────────────────────────────────────────────
+ *
+ * Takes raw input text and produces a ReminderPresentation, or null if the
+ * input does not contain sufficient reminder signal.
+ *
+ * ── What this is NOT ─────────────────────────────────────────────────────────
+ *
+ *   NOT a new interpreter       — does not enter the intake pipeline
+ *   NOT an intake pipeline step — does not affect mode, signal, or intentState
+ *   NOT an execution layer      — does not schedule, store, or trigger anything
+ *   NOT a UCP participant       — produces no envelopes
+ *
+ * ── Architecture position ────────────────────────────────────────────────────
+ *
+ *   Raw input → extractReminderCandidate() → ReminderCandidate | null
+ *                                                      ↓
+ *                                            presentReminder() → ReminderPresentation | null
+ *
+ * presentReminder() is the sole public entry point.
+ * extractReminderCandidate() is exported for testing; internal to this module.
+ *
+ * ── Extraction philosophy ────────────────────────────────────────────────────
+ *
+ *   Conservative: extract only what is EXPLICITLY present.
+ *   If a field cannot be cleanly extracted, it becomes null.
+ *   Null is never defaulted, assumed, or guessed.
+ *   This is a hard contract — the Present Layer does not invent missing facts.
+ *
+ * ── No interpreter changes ───────────────────────────────────────────────────
+ *
+ *   This module does not modify the interpreter registry.
+ *   It does not affect guided_recovery, incomplete, or any pipeline decision.
+ *   Reminder extraction is purely a PRESENTATION-LAYER concern.
+ */
+import type { ReminderCandidate, ReminderPresentation } from "./reminder-types.js";
+/**
+ * Extract all reminder candidate fields from the raw input.
+ *
+ * Returns null if no reminder signal is found.
+ * Returns a ReminderCandidate with null fields where extraction failed.
+ *
+ * The confidence level reflects what was successfully extracted:
+ *   explicit   = subject AND time present
+ *   partial    = exactly one of subject/time present
+ *   ambiguous  = signal matched but neither subject nor time found
+ *
+ * Exported for testing. Not part of the public barrel API.
+ */
+export declare function extractReminderCandidate(input: string): ReminderCandidate | null;
+/**
+ * presentReminder(input) — the sole public function of this module.
+ *
+ * Takes raw input text and produces a ReminderPresentation, or null if the
+ * input does not contain enough reminder signal to justify reminder shaping.
+ *
+ * ── Return null when ─────────────────────────────────────────────────────────
+ *
+ *   The input contains no reminder signal (no "remind me", "set a reminder", etc.)
+ *   In this case, callers should fall back to existing presentation behavior.
+ *
+ * ── Return ReminderPresentation when ────────────────────────────────────────
+ *
+ *   The input contains a reminder signal, even if fields are missing.
+ *   The state field tells the consumer how complete the reminder is.
+ *   Missing fields are listed in missing_fields.
+ *
+ * ── Determinism guarantee ────────────────────────────────────────────────────
+ *
+ *   Same input → same output, always.
+ *   No randomness. No session state. No side effects.
+ */
+export declare function presentReminder(input: string): ReminderPresentation | null;
+//# sourceMappingURL=reminder-presenter.d.ts.map

package/dist/src/present/reminders/reminder-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-presenter.d.ts","sourceRoot":"","sources":["../../../../src/present/reminders/reminder-presenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAEjB,oBAAoB,EAGrB,MAAM,qBAAqB,CAAC;AAkM7B;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAgBhF;AAkFD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAkB1E"}