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

package/README.md

@@ -627,6 +627,31 @@ import 'lax-wp-editor/styles';
 
 You can also customize the styles by overriding CSS variables or using your own CSS.
 
+### Fonts (consumer-provided) — IMPORTANT
+
+The editor wires two font tokens (defined in `src/styles/tokens.css`) to the UI:
+
+- `--font-ui` (**Inter**) → editor chrome/toolbar (the `.lax-wp-editor-host` wrapper)
+- `--font-document` (**Nunito**) → the document content root (`.ProseMirror`)
+
+**This package does NOT ship `@font-face` rules or font binaries.** Inter and
+Nunito are both OFL-licensed (self-hosting is permitted), but to keep the bundle
+lean the faces are not bundled. If your app does not already load Inter and
+Nunito, the editor silently falls back to the token fallback stack (system
+sans-serif) and Nunito/Inter render nowhere.
+
+To get the intended typography, provide the faces in your host app, e.g. via
+`@fontsource/inter` + `@fontsource/nunito`, a self-hosted `@font-face`, or your
+existing font pipeline:
+
+```tsx
+import '@fontsource/inter';   // or your own @font-face for "Inter"
+import '@fontsource/nunito';  // or your own @font-face for "Nunito"
+```
+
+The token wiring already points at these family names, so once the faces are
+available they render automatically — no further config needed.
+
 ## TypeScript Support
 
 The package includes full TypeScript definitions:

package/dist/api/audit.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Audit-trail API module (sprint-2 story 2).
+ *
+ *   GET /v1/audit/export            workspace audit trail, JSON
+ *   GET /v1/audit/export?format=csv CSV download (not used here)
+ *
+ * Shape verified against internal/redlining/api/auditexport.go +
+ * audit.ExportJSON: the body is a TOP-LEVEL ARRAY of events with Go-default
+ * (PascalCase) field names — ID, Kind, EmittedAt, SourceModule, DocumentID,
+ * SuggestionID, RuleID, Actor, Details, … The workspace comes from the
+ * X-Workspace-Id header (tenancy context), never a query param.
+ *
+ * Mirrors `redlines.ts`'s conventions: module-level mutable config merged
+ * with Vite env defaults, zod + `.passthrough()` at the boundary.
+ */
+import { z } from "zod";
+export interface AuditApiConfig {
+    baseUrl?: string;
+    workspaceId?: string;
+}
+/** Configure once from the consumer (App.tsx / lax-web-portal). */
+export declare const configureAuditApi: (next: AuditApiConfig) => void;
+export declare class AuditApiError extends Error {
+    readonly status?: number;
+    constructor(message: string, status?: number);
+}
+declare const auditEventSchema: z.ZodObject<{
+    ID: z.ZodString;
+    WorkspaceID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** e.g. "suggestion_produced", "suggestion_accepted" … */
+    Kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    EmittedAt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    SourceModule: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    DocumentID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    SuggestionID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    RuleID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Actor: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Details: z.ZodOptional<z.ZodUnknown>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    ID: z.ZodString;
+    WorkspaceID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** e.g. "suggestion_produced", "suggestion_accepted" … */
+    Kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    EmittedAt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    SourceModule: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    DocumentID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    SuggestionID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    RuleID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Actor: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Details: z.ZodOptional<z.ZodUnknown>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    ID: z.ZodString;
+    WorkspaceID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** e.g. "suggestion_produced", "suggestion_accepted" … */
+    Kind: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    EmittedAt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    SourceModule: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    DocumentID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    SuggestionID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    RuleID: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Actor: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    Details: z.ZodOptional<z.ZodUnknown>;
+}, z.ZodTypeAny, "passthrough">>;
+export type AuditEvent = z.infer<typeof auditEventSchema>;
+export interface AuditExport {
+    events: AuditEvent[];
+    /**
+     * Pre-limit trail size from the `X-Total-Events` response header
+     * (BE f13904c) — lets the UI render "showing latest N of M" when the
+     * export is limited. Null when the backend doesn't send it.
+     */
+    totalEvents: number | null;
+}
+/**
+ * The calling workspace's audit trail (newest N events), newest first
+ * (sorted here — the export itself is append-ordered).
+ */
+export declare const fetchAuditEvents: () => Promise<AuditExport>;
+export {};

package/dist/api/derivedRulebook.d.ts

@@ -0,0 +1,470 @@
+/**
+ * Derived-rulebook (R1) API module — `FE_INTEGRATION_API.md §2.A`.
+ *
+ * Lifecycle: upload prime → poll job → list candidate rules → approve /
+ * reject / edit / bulk-approve → rulebook status flips to `active` once every
+ * rule of the version is disposed.
+ *
+ * This is the ONLY endpoint family that gives the panel a real
+ * accept/reject-a-rule capability: `/v1/rules` has no enable/disable field,
+ * so "reject" there can only mean DELETE. Here rejection is a first-class,
+ * audited state — rejected rules are retained, never deleted (§2.A).
+ *
+ * Concurrency: every mutation carries the caller's last-seen integer `etag`
+ * and the store compare-and-swaps; a stale etag is a 409, never a clobber
+ * (§3). After an `edit`, use the etag from the edit RESPONSE for the
+ * follow-up approve.
+ */
+import { z } from "zod";
+import { type PlaybookApiConfig } from "./playbook";
+/** Rule states: draft → in_review → approved | rejected (approved/rejected terminal). */
+export declare const derivedRuleStateSchema: z.ZodEnum<["draft", "in_review", "approved", "rejected"]>;
+export type DerivedRuleState = z.infer<typeof derivedRuleStateSchema>;
+/**
+ * `body` is the full contracts.Rule. Passthrough: the doc lists the fields FE
+ * consumes but the struct carries more, and unknown fields must not throw.
+ */
+export declare const derivedRuleBodySchema: z.ZodObject<{
+    id: z.ZodString;
+    playbook_id: z.ZodOptional<z.ZodString>;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    default_severity: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    verbatim_excerpt: z.ZodOptional<z.ZodString>;
+    suggested_text: z.ZodOptional<z.ZodString>;
+    fallback_text: z.ZodOptional<z.ZodString>;
+    walkaway_text: z.ZodOptional<z.ZodString>;
+    rationale: z.ZodOptional<z.ZodString>;
+    mandatory: z.ZodOptional<z.ZodBoolean>;
+    authority: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    prime_section_ref: z.ZodOptional<z.ZodString>;
+    semantic_intent: z.ZodOptional<z.ZodString>;
+    read_only: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    playbook_id: z.ZodOptional<z.ZodString>;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    default_severity: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    verbatim_excerpt: z.ZodOptional<z.ZodString>;
+    suggested_text: z.ZodOptional<z.ZodString>;
+    fallback_text: z.ZodOptional<z.ZodString>;
+    walkaway_text: z.ZodOptional<z.ZodString>;
+    rationale: z.ZodOptional<z.ZodString>;
+    mandatory: z.ZodOptional<z.ZodBoolean>;
+    authority: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    prime_section_ref: z.ZodOptional<z.ZodString>;
+    semantic_intent: z.ZodOptional<z.ZodString>;
+    read_only: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    playbook_id: z.ZodOptional<z.ZodString>;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    default_severity: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    verbatim_excerpt: z.ZodOptional<z.ZodString>;
+    suggested_text: z.ZodOptional<z.ZodString>;
+    fallback_text: z.ZodOptional<z.ZodString>;
+    walkaway_text: z.ZodOptional<z.ZodString>;
+    rationale: z.ZodOptional<z.ZodString>;
+    mandatory: z.ZodOptional<z.ZodBoolean>;
+    authority: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    prime_section_ref: z.ZodOptional<z.ZodString>;
+    semantic_intent: z.ZodOptional<z.ZodString>;
+    read_only: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const derivedRuleSchema: z.ZodObject<{
+    rule_id: z.ZodString;
+    clause_ref: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    rulebook_version: z.ZodOptional<z.ZodNumber>;
+    state: z.ZodEnum<["draft", "in_review", "approved", "rejected"]>;
+    /** Optimistic-concurrency token — echo on every mutation. */
+    etag: z.ZodNumber;
+    body: z.ZodObject<{
+        id: z.ZodString;
+        playbook_id: z.ZodOptional<z.ZodString>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        default_severity: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        verbatim_excerpt: z.ZodOptional<z.ZodString>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        fallback_text: z.ZodOptional<z.ZodString>;
+        walkaway_text: z.ZodOptional<z.ZodString>;
+        rationale: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        authority: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        prime_section_ref: z.ZodOptional<z.ZodString>;
+        semantic_intent: z.ZodOptional<z.ZodString>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodOptional<z.ZodString>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        default_severity: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        verbatim_excerpt: z.ZodOptional<z.ZodString>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        fallback_text: z.ZodOptional<z.ZodString>;
+        walkaway_text: z.ZodOptional<z.ZodString>;
+        rationale: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        authority: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        prime_section_ref: z.ZodOptional<z.ZodString>;
+        semantic_intent: z.ZodOptional<z.ZodString>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodOptional<z.ZodString>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        default_severity: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        verbatim_excerpt: z.ZodOptional<z.ZodString>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        fallback_text: z.ZodOptional<z.ZodString>;
+        walkaway_text: z.ZodOptional<z.ZodString>;
+        rationale: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        authority: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        prime_section_ref: z.ZodOptional<z.ZodString>;
+        semantic_intent: z.ZodOptional<z.ZodString>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    disposed_by: z.ZodOptional<z.ZodString>;
+    disposed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    rule_id: z.ZodString;
+    clause_ref: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    rulebook_version: z.ZodOptional<z.ZodNumber>;
+    state: z.ZodEnum<["draft", "in_review", "approved", "rejected"]>;
+    /** Optimistic-concurrency token — echo on every mutation. */
+    etag: z.ZodNumber;
+    body: z.ZodObject<{
+        id: z.ZodString;
+        playbook_id: z.ZodOptional<z.ZodString>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        default_severity: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        verbatim_excerpt: z.ZodOptional<z.ZodString>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        fallback_text: z.ZodOptional<z.ZodString>;
+        walkaway_text: z.ZodOptional<z.ZodString>;
+        rationale: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        authority: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        prime_section_ref: z.ZodOptional<z.ZodString>;
+        semantic_intent: z.ZodOptional<z.ZodString>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodOptional<z.ZodString>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        default_severity: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        verbatim_excerpt: z.ZodOptional<z.ZodString>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        fallback_text: z.ZodOptional<z.ZodString>;
+        walkaway_text: z.ZodOptional<z.ZodString>;
+        rationale: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        authority: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        prime_section_ref: z.ZodOptional<z.ZodString>;
+        semantic_intent: z.ZodOptional<z.ZodString>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodOptional<z.ZodString>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        default_severity: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        verbatim_excerpt: z.ZodOptional<z.ZodString>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        fallback_text: z.ZodOptional<z.ZodString>;
+        walkaway_text: z.ZodOptional<z.ZodString>;
+        rationale: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        authority: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        prime_section_ref: z.ZodOptional<z.ZodString>;
+        semantic_intent: z.ZodOptional<z.ZodString>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    disposed_by: z.ZodOptional<z.ZodString>;
+    disposed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    rule_id: z.ZodString;
+    clause_ref: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    rulebook_version: z.ZodOptional<z.ZodNumber>;
+    state: z.ZodEnum<["draft", "in_review", "approved", "rejected"]>;
+    /** Optimistic-concurrency token — echo on every mutation. */
+    etag: z.ZodNumber;
+    body: z.ZodObject<{
+        id: z.ZodString;
+        playbook_id: z.ZodOptional<z.ZodString>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        default_severity: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        verbatim_excerpt: z.ZodOptional<z.ZodString>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        fallback_text: z.ZodOptional<z.ZodString>;
+        walkaway_text: z.ZodOptional<z.ZodString>;
+        rationale: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        authority: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        prime_section_ref: z.ZodOptional<z.ZodString>;
+        semantic_intent: z.ZodOptional<z.ZodString>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodOptional<z.ZodString>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        default_severity: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        verbatim_excerpt: z.ZodOptional<z.ZodString>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        fallback_text: z.ZodOptional<z.ZodString>;
+        walkaway_text: z.ZodOptional<z.ZodString>;
+        rationale: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        authority: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        prime_section_ref: z.ZodOptional<z.ZodString>;
+        semantic_intent: z.ZodOptional<z.ZodString>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodOptional<z.ZodString>;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        default_severity: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        verbatim_excerpt: z.ZodOptional<z.ZodString>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        fallback_text: z.ZodOptional<z.ZodString>;
+        walkaway_text: z.ZodOptional<z.ZodString>;
+        rationale: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        authority: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        prime_section_ref: z.ZodOptional<z.ZodString>;
+        semantic_intent: z.ZodOptional<z.ZodString>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    disposed_by: z.ZodOptional<z.ZodString>;
+    disposed_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const derivedRulebookSchema: z.ZodObject<{
+    prime_contract_id: z.ZodString;
+    latest_version: z.ZodOptional<z.ZodNumber>;
+    active_version: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodString>;
+    bundle_hash: z.ZodOptional<z.ZodString>;
+    counts: z.ZodOptional<z.ZodObject<{
+        draft: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        in_review: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        approved: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        rejected: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        approved?: number | undefined;
+        rejected?: number | undefined;
+        draft?: number | undefined;
+        in_review?: number | undefined;
+    }, {
+        approved?: number | undefined;
+        rejected?: number | undefined;
+        draft?: number | undefined;
+        in_review?: number | undefined;
+    }>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    prime_contract_id: z.ZodString;
+    latest_version: z.ZodOptional<z.ZodNumber>;
+    active_version: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodString>;
+    bundle_hash: z.ZodOptional<z.ZodString>;
+    counts: z.ZodOptional<z.ZodObject<{
+        draft: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        in_review: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        approved: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        rejected: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        approved?: number | undefined;
+        rejected?: number | undefined;
+        draft?: number | undefined;
+        in_review?: number | undefined;
+    }, {
+        approved?: number | undefined;
+        rejected?: number | undefined;
+        draft?: number | undefined;
+        in_review?: number | undefined;
+    }>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    prime_contract_id: z.ZodString;
+    latest_version: z.ZodOptional<z.ZodNumber>;
+    active_version: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodString>;
+    bundle_hash: z.ZodOptional<z.ZodString>;
+    counts: z.ZodOptional<z.ZodObject<{
+        draft: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        in_review: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        approved: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        rejected: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        approved?: number | undefined;
+        rejected?: number | undefined;
+        draft?: number | undefined;
+        in_review?: number | undefined;
+    }, {
+        approved?: number | undefined;
+        rejected?: number | undefined;
+        draft?: number | undefined;
+        in_review?: number | undefined;
+    }>>;
+}, z.ZodTypeAny, "passthrough">>;
+/** `state`: queued → running → complete | failed. */
+export declare const derivationJobSchema: z.ZodObject<{
+    job_id: z.ZodString;
+    prime_contract_id: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<["queued", "running", "complete", "failed"]>;
+    attempts: z.ZodOptional<z.ZodNumber>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    updated_at: z.ZodOptional<z.ZodString>;
+    /** Present ONLY when state === "complete". */
+    result: z.ZodOptional<z.ZodObject<{
+        rules: z.ZodOptional<z.ZodNumber>;
+        extracted_count: z.ZodOptional<z.ZodNumber>;
+        faithfulness_rejections: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        rules: z.ZodOptional<z.ZodNumber>;
+        extracted_count: z.ZodOptional<z.ZodNumber>;
+        faithfulness_rejections: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        rules: z.ZodOptional<z.ZodNumber>;
+        extracted_count: z.ZodOptional<z.ZodNumber>;
+        faithfulness_rejections: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    job_id: z.ZodString;
+    prime_contract_id: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<["queued", "running", "complete", "failed"]>;
+    attempts: z.ZodOptional<z.ZodNumber>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    updated_at: z.ZodOptional<z.ZodString>;
+    /** Present ONLY when state === "complete". */
+    result: z.ZodOptional<z.ZodObject<{
+        rules: z.ZodOptional<z.ZodNumber>;
+        extracted_count: z.ZodOptional<z.ZodNumber>;
+        faithfulness_rejections: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        rules: z.ZodOptional<z.ZodNumber>;
+        extracted_count: z.ZodOptional<z.ZodNumber>;
+        faithfulness_rejections: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        rules: z.ZodOptional<z.ZodNumber>;
+        extracted_count: z.ZodOptional<z.ZodNumber>;
+        faithfulness_rejections: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    job_id: z.ZodString;
+    prime_contract_id: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<["queued", "running", "complete", "failed"]>;
+    attempts: z.ZodOptional<z.ZodNumber>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    updated_at: z.ZodOptional<z.ZodString>;
+    /** Present ONLY when state === "complete". */
+    result: z.ZodOptional<z.ZodObject<{
+        rules: z.ZodOptional<z.ZodNumber>;
+        extracted_count: z.ZodOptional<z.ZodNumber>;
+        faithfulness_rejections: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        rules: z.ZodOptional<z.ZodNumber>;
+        extracted_count: z.ZodOptional<z.ZodNumber>;
+        faithfulness_rejections: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        rules: z.ZodOptional<z.ZodNumber>;
+        extracted_count: z.ZodOptional<z.ZodNumber>;
+        faithfulness_rejections: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type DerivedRule = z.infer<typeof derivedRuleSchema>;
+export type DerivedRulebook = z.infer<typeof derivedRulebookSchema>;
+export type DerivationJob = z.infer<typeof derivationJobSchema>;
+export interface DerivedRulesPage {
+    rulebook?: DerivedRulebook;
+    version?: number;
+    rules: DerivedRule[];
+}
+/**
+ * Lists candidate rules. ALL states are returned — rejected rules stay
+ * visible as audit records, so the UI filters rather than assuming absence.
+ * `version` defaults to latest.
+ */
+export declare const listDerivedRules: (prime: string, options?: {
+    version?: number;
+}) => Promise<DerivedRulesPage>;
+/** Rulebook status + per-state counts (counts are status-endpoint only). */
+export declare const getDerivedRulebookStatus: (prime: string) => Promise<DerivedRulebook>;
+export declare const getDerivationJob: (prime: string, jobId: string) => Promise<DerivationJob>;
+export interface DisposeOptions {
+    /** Last-seen etag. A stale value is a 409 — refresh and retry. */
+    etag: number;
+    /** 0/omitted = latest version. */
+    version?: number;
+    note?: string;
+}
+export declare const approveDerivedRule: (prime: string, ruleId: string, options: DisposeOptions) => Promise<DerivedRule>;
+export declare const rejectDerivedRule: (prime: string, ruleId: string, options: DisposeOptions) => Promise<DerivedRule>;
+/**
+ * Counsel tweaks a generated rule before disposing it. `body` REPLACES the
+ * stored rule wholesale — send the full edited contracts.Rule, not a patch.
+ * Disposed rules are immutable (409). The response carries a bumped etag;
+ * use THAT for a follow-up approve.
+ */
+export declare const editDerivedRule: (prime: string, ruleId: string, options: DisposeOptions & {
+    body: Record<string, unknown>;
+    clauseRef?: string;
+}) => Promise<DerivedRule>;
+/**
+ * All-or-nothing in one transaction: ANY stale etag rolls the whole batch
+ * back with a single 409 and nothing is applied. Returns the rulebook DTO,
+ * not the rules — re-list to refresh etags/states.
+ */
+export declare const bulkApproveDerivedRules: (prime: string, rules: readonly {
+    ruleId: string;
+    etag: number;
+}[], options?: {
+    version?: number;
+    note?: string;
+}) => Promise<DerivedRulebook>;
+/**
+ * Uploads the prime contract DOCX. The multipart field MUST be named `file`
+ * — any other name is a 400. Content-Type is deliberately NOT set: the
+ * browser must add its own multipart boundary.
+ */
+export declare const uploadPrimeContract: (prime: string, file: File | Blob) => Promise<DerivationJob>;
+export declare const retryDerivationJob: (prime: string, jobId: string) => Promise<DerivationJob>;
+export type { PlaybookApiConfig };