@lax-wp/editor 0.4.13 → 0.4.15-beta.0

package/dist/api/r1.fixtures.d.ts

@@ -0,0 +1,111 @@
+/**
+ * R1 mock fixtures — the complete dataset behind api/r1.ts mock mode.
+ *
+ * Exercises every UI state: derivation jobs in queued → running → complete
+ * progression, a retryable failure, a zero-obligation clean result; candidate
+ * rules across all three classifications and all disposition states; findings
+ * provenance (prime / cdts / superseded-by-regulatory); suggestion positions;
+ * suppressed findings; and the review summary. Plain data + a small stateful
+ * store so approve/reject/bulk flows behave like the real backend will.
+ *
+ * Types are structural here (no import from ./r1) to avoid a module cycle;
+ * ./r1 zod-validates nothing in mock mode — these objects ARE the contract
+ * fixtures and are asserted against the schemas in tests.
+ */
+export interface FixtureJob {
+    job_id: string;
+    prime_contract_id?: string;
+    file_name?: string;
+    status: "queued" | "running" | "failed" | "complete";
+    retryable?: boolean;
+    error?: string;
+    progress?: number;
+    result?: {
+        derived_playbook_id?: string;
+        candidate_rule_count: number;
+        zero_obligations?: boolean;
+    };
+}
+/** Fresh-upload job: polls advance it queued → running → complete. */
+export declare const jobQueued: FixtureJob;
+export declare const jobRunning: FixtureJob;
+export declare const jobFailedRetryable: FixtureJob;
+export declare const jobFailedFatal: FixtureJob;
+export declare const jobComplete: FixtureJob;
+/** Clean result: completed derivation that found nothing to flow down. */
+export declare const jobZeroObligations: FixtureJob;
+export declare const allJobs: FixtureJob[];
+export interface FixtureCandidate {
+    id: string;
+    playbook_id: string;
+    verbatim_excerpt: string;
+    section_citation: string;
+    classification: "mandatory" | "conditionally_mandatory" | "discretionary";
+    generated_rule_text: string;
+    rationale: string;
+    status: "pending" | "approved" | "rejected";
+    approved_text?: string;
+    disposed_by?: string;
+}
+export declare const DERIVED_PLAYBOOK_ID = "pbd-prime-001";
+export declare const candidateRules: FixtureCandidate[];
+export declare const provenancePrime: {
+    source: "prime";
+    prime_contract_id: string;
+    prime_section_ref: string;
+    source_excerpt: string;
+};
+export declare const provenanceCdts: {
+    source: "cdts";
+    source_excerpt: string;
+};
+export declare const provenanceSuperseded: {
+    source: "prime";
+    prime_contract_id: string;
+    prime_section_ref: string;
+    source_excerpt: string;
+    superseded_by_regulatory: boolean;
+};
+export declare const positionsFull: {
+    preferred: string;
+    fallback: string;
+    walkaway: string;
+};
+export declare const positionsPreferredOnly: {
+    preferred: string;
+};
+export declare const reviewSummary: {
+    by_provenance: {
+        prime: number;
+        cdts: number;
+    };
+    by_severity: {
+        high: number;
+        medium: number;
+        low: number;
+    };
+    missing_flowdown_count: number;
+    escalation_count: number;
+    suppressed_count: number;
+};
+export interface MockR1Store {
+    uploadPrime: (fileName: string) => FixtureJob;
+    getJob: (jobId: string) => FixtureJob | null;
+    retryJob: (jobId: string) => FixtureJob | null;
+    listCandidates: (playbookId: string) => FixtureCandidate[];
+    dispose: (candidateId: string, status: "approved" | "rejected", disposedBy?: string, editedText?: string) => FixtureCandidate | null;
+    rulebookStatus: (playbookId: string) => {
+        playbook_id: string;
+        total: number;
+        disposed: number;
+        active: boolean;
+    };
+    reviewSummary: () => typeof reviewSummary;
+}
+/**
+ * Fresh mutable store seeded from the fixtures. Uploaded jobs progress one
+ * state per poll (queued → running → complete); file names containing "fail"
+ * produce a retryable failure and names containing "empty" a zero-obligation
+ * result, so every state is reachable from the live upload screen too.
+ */
+export declare const createMockR1Store: () => MockR1Store;

package/dist/api/redlineJobs.d.ts

@@ -0,0 +1,377 @@
+/**
+ * Redline polling transport + single-record fetch.
+ *
+ *   POST /v1/redline/async        202 {job_id, status:"queued"}
+ *   GET  /v1/redline/jobs/{id}    200 {job_id, status, result?, error?}
+ *   GET  /api/redlines/{id}       200 one persisted suggestion Record
+ *
+ * ── Status of this module, stated plainly ────────────────────────────────
+ * SSE (`redlineStream.ts`) is the product path. This is the fallback
+ * transport: same orchestrator loop, no incremental frames, one JSON result
+ * at the end. It earns its place when SSE cannot be used — a proxy that
+ * buffers text/event-stream, a corporate network that kills long-lived
+ * connections — not as a second way to run a normal review.
+ *
+ * Persistence parity with SSE: since backend commit `0d94b43`, the job runner
+ * replays a finished review's suggestions through the SAME proposeSink the SSE
+ * transport uses, BEFORE the job flips to succeeded — so by the time a poll
+ * observes `succeeded`, every suggestion in the result has a `proposed` record
+ * in the disposition store and accept/reject on it works. Verified live on
+ * 2026-08-17 against a HEAD server: async submit → succeeded →
+ * `GET /api/redlines?document_id=` returned the record → PATCH accept 200.
+ * (Before that commit the async path skipped the store entirely and
+ * dispositions 404ed.) `asyncResultsArePersisted` below is the single place
+ * that claim is encoded — gate on it, don't re-derive it.
+ *
+ * `getRedlineRecord` (GET /api/redlines/{id}) is the third route here because
+ * `src/api/redlines.ts` — where it would naturally live next to
+ * `listRedlineRecords` — is owned by another workstream in this sprint. It is a
+ * deliberate, documented placement, not a design view.
+ *
+ * Base URL: these are redlining-server routes, so VITE_LAX_AI_REDLINE_URL wins
+ * when set; it falls back to VITE_LAX_AI_PLAYBOOK_URL because the consolidated
+ * binary serves both families on one host and only the playbook var is set in
+ * local dev (.env.local).
+ */
+import { z } from "zod";
+export interface RedlineJobsApiConfig {
+    baseUrl?: string;
+    workspaceId?: string;
+    getAuthToken?: () => string | undefined | Promise<string | undefined>;
+}
+/** Configure once from the consumer (App.tsx / lax-web-portal). */
+export declare const configureRedlineJobsApi: (next: RedlineJobsApiConfig) => void;
+export declare class RedlineJobsApiError extends Error {
+    readonly status?: number;
+    /** Canonical `code` from the error envelope, when the body carries one. */
+    readonly code?: string;
+    constructor(message: string, status?: number, code?: string);
+}
+/** store.Status values (internal/redlining/store/store.go). */
+export type RedlineJobStatus = "queued" | "running" | "succeeded" | "failed";
+/** True once the job will not change state again. */
+export declare const isTerminalJobStatus: (status: string) => boolean;
+/**
+ * Whether a review run through the async transport lands in the disposition
+ * store (and so can be accepted/rejected). TRUE since backend `0d94b43`
+ * (propose-before-succeeded replay through the SSE proposeSink — see the
+ * module docstring; verified live 2026-08-17). Exported so callers branch on
+ * the fact instead of re-deriving it; consumers (useRedlineReview's fallback)
+ * use it to decide whether async suggestions get the full accept/reject
+ * materializer or a display-only rendering.
+ */
+export declare const asyncResultsArePersisted = true;
+export declare const asyncSubmitSchema: z.ZodObject<{
+    job_id: z.ZodString;
+    status: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    job_id: z.ZodString;
+    status: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    job_id: z.ZodString;
+    status: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+/** The subset of the review request body this transport sends. */
+export interface AsyncReviewRequest {
+    document_id: string;
+    /** Canonical TipTap/ProseMirror document. Preferred over `document`. */
+    doc?: unknown;
+    /** Legacy raw-text input; used only when `doc` is absent. */
+    document?: string;
+    regimes?: string[];
+    markup_mode?: string;
+    schema_version?: string;
+    prime_contract_id?: string;
+    counterparty_type?: string;
+    strictness?: "" | "strict" | "permissive";
+    disabled_rule_ids?: string[];
+    rule_ids?: string[];
+    disabled_playbook_ids?: string[];
+}
+export interface SubmitAsyncOptions {
+    /**
+     * REQUIRED by the server — a submit without `Idempotency-Key` is a 400.
+     *
+     * A repeat submit with the same key returns the EXISTING job id and does not
+     * kick a second run — verified live: two posts, one job. The server does not
+     * exempt a FAILED job from that, so a key derived only from the review's
+     * identity pins a caller to a failed job forever, which is fatal for a
+     * transport whose whole purpose is retrying after SSE fails. Derive it from
+     * document + settings + an ATTEMPT counter: stable enough that a double
+     * click is deduplicated, distinct enough that a deliberate retry re-runs.
+     */
+    idempotencyKey: string;
+    signal?: AbortSignal;
+}
+/** Submit a review for background processing. Resolves to the job id. */
+export declare const submitAsyncReview: (request: AsyncReviewRequest, opts: SubmitAsyncOptions) => Promise<{
+    jobId: string;
+    status: string;
+}>;
+/**
+ * `result` is a json.RawMessage server-side, so it arrives as the review
+ * response OBJECT (not a JSON string). Left unvalidated here: it is the full
+ * ReviewResponse and validating it is redlineStream.ts's contract, not this
+ * module's transport concern.
+ */
+export declare const redlineJobSchema: z.ZodObject<{
+    job_id: z.ZodString;
+    status: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    job_id: z.ZodString;
+    status: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    job_id: z.ZodString;
+    status: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type RedlineJob = z.infer<typeof redlineJobSchema>;
+/** Poll one job. A job owned by another workspace 404s, same as an unknown id. */
+export declare const getRedlineJob: (jobId: string, opts?: {
+    signal?: AbortSignal;
+}) => Promise<RedlineJob>;
+export interface AwaitJobOptions {
+    /** Poll interval in ms (default 2000). */
+    intervalMs?: number;
+    /** Give up after this long (default 15 min — the server's own run cap). */
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    /** Called on every poll, including the terminal one. */
+    onPoll?: (job: RedlineJob) => void;
+}
+/**
+ * Poll until the job reaches a terminal state, then return it. A `failed` job
+ * is RETURNED, not thrown — the caller decides whether a failed review is an
+ * error or a state to render. Only transport faults and the timeout throw.
+ */
+export declare const awaitRedlineJob: (jobId: string, opts?: AwaitJobOptions) => Promise<RedlineJob>;
+/**
+ * One persisted suggestion record. NOTE the capitalized keys: the Go
+ * `suggestion.Record` struct carries NO json tags, so its field names ride the
+ * wire verbatim (`ID`, `State`, `Suggestion`, ...). The nested `Suggestion` is
+ * the v6 payload and IS snake_case. Verified against a live 200.
+ */
+export declare const redlineRecordSchema: z.ZodObject<{
+    ID: z.ZodString;
+    WorkspaceID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    DocumentID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Lane: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** "proposed" | "accepted" | "rejected" | "ignored" | "dropped" */
+    State: z.ZodString;
+    RejectScope: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    RejectNote: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    CreatedAt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    UpdatedAt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Suggestion: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        document_id: z.ZodOptional<z.ZodString>;
+        position_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        text: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        severity: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        state: z.ZodOptional<z.ZodString>;
+        reviewed_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reviewed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        citation: z.ZodOptional<z.ZodObject<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodOptional<z.ZodString>;
+        document_id: z.ZodOptional<z.ZodString>;
+        position_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        text: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        severity: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        state: z.ZodOptional<z.ZodString>;
+        reviewed_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reviewed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        citation: z.ZodOptional<z.ZodObject<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodOptional<z.ZodString>;
+        document_id: z.ZodOptional<z.ZodString>;
+        position_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        text: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        severity: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        state: z.ZodOptional<z.ZodString>;
+        reviewed_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reviewed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        citation: z.ZodOptional<z.ZodObject<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    ID: z.ZodString;
+    WorkspaceID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    DocumentID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Lane: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** "proposed" | "accepted" | "rejected" | "ignored" | "dropped" */
+    State: z.ZodString;
+    RejectScope: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    RejectNote: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    CreatedAt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    UpdatedAt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Suggestion: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        document_id: z.ZodOptional<z.ZodString>;
+        position_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        text: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        severity: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        state: z.ZodOptional<z.ZodString>;
+        reviewed_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reviewed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        citation: z.ZodOptional<z.ZodObject<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodOptional<z.ZodString>;
+        document_id: z.ZodOptional<z.ZodString>;
+        position_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        text: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        severity: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        state: z.ZodOptional<z.ZodString>;
+        reviewed_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reviewed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        citation: z.ZodOptional<z.ZodObject<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodOptional<z.ZodString>;
+        document_id: z.ZodOptional<z.ZodString>;
+        position_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        text: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        severity: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        state: z.ZodOptional<z.ZodString>;
+        reviewed_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reviewed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        citation: z.ZodOptional<z.ZodObject<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    ID: z.ZodString;
+    WorkspaceID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    DocumentID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Lane: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** "proposed" | "accepted" | "rejected" | "ignored" | "dropped" */
+    State: z.ZodString;
+    RejectScope: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    RejectNote: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    CreatedAt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    UpdatedAt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Suggestion: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        document_id: z.ZodOptional<z.ZodString>;
+        position_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        text: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        severity: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        state: z.ZodOptional<z.ZodString>;
+        reviewed_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reviewed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        citation: z.ZodOptional<z.ZodObject<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodOptional<z.ZodString>;
+        document_id: z.ZodOptional<z.ZodString>;
+        position_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        text: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        severity: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        state: z.ZodOptional<z.ZodString>;
+        reviewed_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reviewed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        citation: z.ZodOptional<z.ZodObject<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodOptional<z.ZodString>;
+        document_id: z.ZodOptional<z.ZodString>;
+        position_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        text: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        severity: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        state: z.ZodOptional<z.ZodString>;
+        reviewed_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reviewed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        citation: z.ZodOptional<z.ZodObject<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            rule_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, z.ZodTypeAny, "passthrough">>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type RedlineRecord = z.infer<typeof redlineRecordSchema>;
+/**
+ * Fetch ONE persisted suggestion by id — the refresh-one-item read, as
+ * opposed to `listRedlineRecords` (redlines.ts), which re-pulls a whole
+ * document. Errors: 404 for an unknown id AND for a record owned by another
+ * workspace (deliberately indistinguishable, so an id cannot be probed
+ * cross-tenant), plain-text body.
+ */
+export declare const getRedlineRecord: (id: string, opts?: {
+    signal?: AbortSignal;
+}) => Promise<RedlineRecord>;