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

package/dist/api/playbook.d.ts

@@ -0,0 +1,604 @@
+/**
+ * Playbook / rules API module — REQ-D1..D5.
+ *
+ * ALL playbook and rule HTTP lives here. Every response is validated with
+ * zod at the boundary; components never fetch directly and never see
+ * unvalidated JSON. Auth-header pass-through, error normalization, and
+ * caching (playbooks per workspace, rules per playbook id, invalidated on
+ * any rule save) also live here.
+ *
+ * Write paths (createRule / updateRule / duplicate) are fully built but
+ * merge-gated at PR level until backend persistence lands (REQ-S2).
+ */
+import { z } from "zod";
+import { type CdtsScope } from "@/utils/cdts";
+export declare const cdtsScopeSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    subtype: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    category: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    subtype: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    category: z.ZodOptional<z.ZodString>;
+    domain: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    subtype: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const ruleSchema: z.ZodObject<{
+    id: z.ZodString;
+    playbook_id: z.ZodString;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    /** Optional display name; fall back via ruleDisplayName(). */
+    name: z.ZodOptional<z.ZodString>;
+    category: z.ZodString;
+    default_severity: z.ZodString;
+    verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+    standard_position: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        text: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        text: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    suggested_text: z.ZodOptional<z.ZodString>;
+    authority: z.ZodOptional<z.ZodString>;
+    mandatory: z.ZodOptional<z.ZodBoolean>;
+    read_only: z.ZodOptional<z.ZodBoolean>;
+    source: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    playbook_id: z.ZodString;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    /** Optional display name; fall back via ruleDisplayName(). */
+    name: z.ZodOptional<z.ZodString>;
+    category: z.ZodString;
+    default_severity: z.ZodString;
+    verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+    standard_position: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        text: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        text: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    suggested_text: z.ZodOptional<z.ZodString>;
+    authority: z.ZodOptional<z.ZodString>;
+    mandatory: z.ZodOptional<z.ZodBoolean>;
+    read_only: z.ZodOptional<z.ZodBoolean>;
+    source: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    playbook_id: z.ZodString;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    /** Optional display name; fall back via ruleDisplayName(). */
+    name: z.ZodOptional<z.ZodString>;
+    category: z.ZodString;
+    default_severity: z.ZodString;
+    verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+    standard_position: z.ZodOptional<z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        text: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        text: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    suggested_text: z.ZodOptional<z.ZodString>;
+    authority: z.ZodOptional<z.ZodString>;
+    mandatory: z.ZodOptional<z.ZodBoolean>;
+    read_only: z.ZodOptional<z.ZodBoolean>;
+    source: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const playbookSchema: z.ZodObject<{
+    id: z.ZodString;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    regime: z.ZodOptional<z.ZodString>;
+    /** "base" on the bundled starter chain, "custom" on workspace-created. */
+    kind: z.ZodOptional<z.ZodString>;
+    scope: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    version: z.ZodOptional<z.ZodNumber>;
+    effective_from: z.ZodOptional<z.ZodString>;
+    read_only: z.ZodOptional<z.ZodBoolean>;
+    bundled: z.ZodOptional<z.ZodBoolean>;
+    /** REQ-D2: the ?cdts= response includes each chain playbook's rules inline. */
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        playbook_id: z.ZodString;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        /** Optional display name; fall back via ruleDisplayName(). */
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodString;
+        default_severity: z.ZodString;
+        verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+        standard_position: z.ZodOptional<z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        authority: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodString;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        /** Optional display name; fall back via ruleDisplayName(). */
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodString;
+        default_severity: z.ZodString;
+        verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+        standard_position: z.ZodOptional<z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        authority: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodString;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        /** Optional display name; fall back via ruleDisplayName(). */
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodString;
+        default_severity: z.ZodString;
+        verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+        standard_position: z.ZodOptional<z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        authority: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    regime: z.ZodOptional<z.ZodString>;
+    /** "base" on the bundled starter chain, "custom" on workspace-created. */
+    kind: z.ZodOptional<z.ZodString>;
+    scope: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    version: z.ZodOptional<z.ZodNumber>;
+    effective_from: z.ZodOptional<z.ZodString>;
+    read_only: z.ZodOptional<z.ZodBoolean>;
+    bundled: z.ZodOptional<z.ZodBoolean>;
+    /** REQ-D2: the ?cdts= response includes each chain playbook's rules inline. */
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        playbook_id: z.ZodString;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        /** Optional display name; fall back via ruleDisplayName(). */
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodString;
+        default_severity: z.ZodString;
+        verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+        standard_position: z.ZodOptional<z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        authority: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodString;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        /** Optional display name; fall back via ruleDisplayName(). */
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodString;
+        default_severity: z.ZodString;
+        verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+        standard_position: z.ZodOptional<z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        authority: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodString;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        /** Optional display name; fall back via ruleDisplayName(). */
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodString;
+        default_severity: z.ZodString;
+        verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+        standard_position: z.ZodOptional<z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        authority: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    regime: z.ZodOptional<z.ZodString>;
+    /** "base" on the bundled starter chain, "custom" on workspace-created. */
+    kind: z.ZodOptional<z.ZodString>;
+    scope: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    version: z.ZodOptional<z.ZodNumber>;
+    effective_from: z.ZodOptional<z.ZodString>;
+    read_only: z.ZodOptional<z.ZodBoolean>;
+    bundled: z.ZodOptional<z.ZodBoolean>;
+    /** REQ-D2: the ?cdts= response includes each chain playbook's rules inline. */
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        playbook_id: z.ZodString;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        /** Optional display name; fall back via ruleDisplayName(). */
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodString;
+        default_severity: z.ZodString;
+        verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+        standard_position: z.ZodOptional<z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        authority: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodString;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        /** Optional display name; fall back via ruleDisplayName(). */
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodString;
+        default_severity: z.ZodString;
+        verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+        standard_position: z.ZodOptional<z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        authority: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        playbook_id: z.ZodString;
+        workspace_id: z.ZodOptional<z.ZodString>;
+        /** Optional display name; fall back via ruleDisplayName(). */
+        name: z.ZodOptional<z.ZodString>;
+        category: z.ZodString;
+        default_severity: z.ZodString;
+        verbatim_excerpt: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /** Phase-4 backend field: replaces `verbatim_excerpt` in responses. */
+        standard_position: z.ZodOptional<z.ZodObject<{
+            text: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            text: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>>;
+        rationale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        suggested_text: z.ZodOptional<z.ZodString>;
+        authority: z.ZodOptional<z.ZodString>;
+        mandatory: z.ZodOptional<z.ZodBoolean>;
+        read_only: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const citationSchema: z.ZodObject<{
+    playbook_id: z.ZodString;
+    playbook_scope: z.ZodOptional<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    rule_id: z.ZodString;
+    verbatim_excerpt: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    playbook_id: z.ZodString;
+    playbook_scope: z.ZodOptional<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    rule_id: z.ZodString;
+    verbatim_excerpt: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    playbook_id: z.ZodString;
+    playbook_scope: z.ZodOptional<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        category: z.ZodOptional<z.ZodString>;
+        domain: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        subtype: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    rule_id: z.ZodString;
+    verbatim_excerpt: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type Rule = z.infer<typeof ruleSchema>;
+export type Playbook = z.infer<typeof playbookSchema>;
+export type Citation = z.infer<typeof citationSchema>;
+export type { CdtsScope };
+/** Display name fallback chain: name → rationale → id. */
+export declare const ruleDisplayName: (rule: Rule) => string;
+/**
+ * Rule text fallback chain: standard_position.text → verbatim_excerpt.
+ * Deliberately NOT falling back to `rationale` — it carries the display name
+ * (see draftToPayload), and that fallback silently replaced rule text with
+ * the name on edit/duplicate round-trips.
+ */
+export declare const ruleText: (rule: Rule) => string;
+/**
+ * Bundled (product-shipped, read-only) detection.
+ *
+ * The backend exposes NO `bundled`/`read_only` field on playbooks today — the
+ * embedded starter bundle is only identifiable by its id prefix (the loader in
+ * `playbooks/v1/` emits ids like `v1-gov-flow-down`; every rule it derives also
+ * carries a `[STARTER]` excerpt prefix). `pb_v1_` is kept for older fixtures.
+ *
+ * This stays a heuristic until the backend ships an explicit flag; when it
+ * does, the `??` chain below picks it up with no other change.
+ */
+export declare const isBundledPlaybook: (pb: Playbook) => boolean;
+export type PlaybookApiErrorKind = "network" | "http" | "parse" | "unauthorized" | "forbidden" | "conflict" | "not_found" | "rate_limited" | "not_implemented" | "dependency_unavailable";
+export declare class PlaybookApiError extends Error {
+    readonly kind: PlaybookApiErrorKind;
+    readonly status?: number;
+    /** Canonical `code` from the error envelope (FE_INTEGRATION_API §1.3). */
+    readonly code?: string;
+    /** From `details.retry_after_seconds` on a 503. */
+    readonly retryAfterSeconds?: number;
+    constructor(kind: PlaybookApiErrorKind, message: string, status?: number, code?: string, retryAfterSeconds?: number);
+}
+export interface PlaybookApiConfig {
+    /** Service base URL, e.g. https://host/api/v1/lax-ai-legal-editor */
+    baseUrl?: string;
+    /** Returns the bearer token (sync or async); omitted → no auth header. */
+    getAuthToken?: () => string | undefined | Promise<string | undefined>;
+    /** Workspace key for the playbook cache (REQ-D5). */
+    workspaceId?: string;
+}
+/** Configure once from the consumer (lax-web-portal) or PlaybookPanel props. */
+export declare const configurePlaybookApi: (next: PlaybookApiConfig) => void;
+/**
+ * Shared fetch core. Exported so sibling API modules (derivedRulebook.ts,
+ * pii.ts) reuse one auth/error/validation path rather than re-implementing
+ * it. `opts` overrides base URL / workspace for modules with their own
+ * config (pii.ts) — omit for the playbook config.
+ */
+export declare const request: <S extends z.ZodTypeAny>(path: string, schema: S, init?: RequestInit, opts?: Pick<PlaybookApiConfig, "baseUrl" | "workspaceId">) => Promise<z.output<S>>;
+/** Invalidate on any rule save (REQ-D5). */
+export declare const invalidatePlaybookCaches: () => void;
+export interface ListPlaybooksOptions {
+    /**
+     * REQ-D2: document coordinate for the server-authoritative walk-up filter
+     * (`GET /v1/playbooks?cdts=`). If the backend rejects the param (400),
+     * degrades to an unfiltered fetch + client-side chain filter with a
+     * console.warn.
+     */
+    cdts?: CdtsScope;
+    forceRefresh?: boolean;
+}
+export declare const listPlaybooks: (options?: ListPlaybooksOptions) => Promise<Playbook[]>;
+/** Single-rule read (conflict-reload path in the editor modal). Uncached. */
+export declare const getRule: (ruleId: string) => Promise<Rule>;
+export interface ListRulesOptions {
+    /**
+     * The playbook's current version. The versioned read is the ONLY rule-list
+     * route the backend serves; when this is omitted the version is resolved
+     * first via `GET /v1/playbooks/{id}`.
+     */
+    version?: number;
+    forceRefresh?: boolean;
+}
+export declare const listRules: (playbookId: string, options?: ListRulesOptions) => Promise<Rule[]>;
+/** The rule editor's save payload (REQ-M2 fields). */
+export interface RuleDraft {
+    /** Stable per editing session — double-submit posts the same id (REQ-M3). */
+    id: string;
+    name: string;
+    /** V6 category (mapped from the display category chip-select). */
+    category: string;
+    /** V6 severity (mapped from the tier segmented control). */
+    severity: string;
+    /** Rule text. Rendered as text, never HTML (REQ-D5). */
+    text: string;
+    /**
+     * Applies-to scope (REQ-M2): the workspace playbook at a CDTS coordinate,
+     * or this document only (doc-rules store; synthetic `doc:` playbook id
+     * pending a dedicated doc-rules endpoint).
+     */
+    scope: {
+        kind: "playbook";
+        playbookId: string;
+    } | {
+        kind: "document";
+        documentId: string;
+        /**
+         * The document's CDTS scope — carried onto the auto-created
+         * `doc:<id>` playbook (the backend rejects a scopeless non-base
+         * playbook, so it must have at least scope.category).
+         */
+        scope?: CdtsScope;
+    };
+}
+export declare const createRule: (draft: RuleDraft) => Promise<Rule>;
+export declare const updateRule: (draft: RuleDraft) => Promise<Rule>;
+/**
+ * Deletes a rule. The backend guards bundled/read-only rules and answers 403
+ * (`projection.ErrReadOnly`), so callers must not offer this on bundled rules;
+ * the 403 is a backstop, not the UX.
+ */
+export declare const deleteRule: (ruleId: string) => Promise<void>;
+/**
+ * REQ-R4: duplicating a bundled rule creates an editable workspace copy that
+ * wins over the bundled original. Goes through createRule (single write path).
+ */
+export declare const duplicateRuleToWorkspace: (rule: Rule, targetPlaybookId: string) => Promise<Rule>;
+/**
+ * Deletes a playbook (`DELETE /v1/playbooks/{id}` → 204 | 404 | 400).
+ * Base (bundled) playbooks are undeletable — bundled content reloads from the
+ * binary at boot — and answer 400 with code `base_playbook_undeletable`;
+ * callers render that envelope's message (it points at per-run exclusion
+ * instead). Callers must not offer this on bundled playbooks; the 400 is a
+ * backstop, not the UX.
+ */
+export declare const deletePlaybook: (playbookId: string) => Promise<void>;
+/**
+ * The create payload `POST /v1/playbooks` validates: id, name and regime are
+ * required, and a playbook without scope.category must be kind="base" — so
+ * workspace copies always carry at least the source's category.
+ */
+export interface PlaybookDraft {
+    id: string;
+    name: string;
+    regime: string;
+    scope: CdtsScope;
+}
+export declare const createPlaybook: (draft: PlaybookDraft) => Promise<Playbook>;
+/**
+ * Duplicates a whole (typically bundled) playbook into an editable workspace
+ * copy: one createPlaybook, then each rule copied via duplicateRuleToWorkspace
+ * (single write path). Rules copy sequentially so a mid-way failure leaves a
+ * usable partial copy rather than an interleaved mess.
+ */
+export declare const duplicatePlaybookToWorkspace: (source: Playbook) => Promise<Playbook>;