@42ch/spoke-schemas 0.1.0-alpha.1

package/dist/index.d.mts

@@ -0,0 +1,2296 @@
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Wire schema version (integer >= 1).
+ *
+ * This interface was referenced by `SPOKECommonTypes`'s JSON-Schema
+ * via the `definition` "SchemaVersion".
+ */
+type SchemaVersion = number;
+/**
+ * RFC 3339 UTC datetime string.
+ *
+ * This interface was referenced by `SPOKECommonTypes`'s JSON-Schema
+ * via the `definition` "Timestamp".
+ */
+type Timestamp = string;
+/**
+ * L5 Timeline projection tier (open string). Core vocabulary (documented, not enforced): brief, narrative, moment. Wire field name timeline_scale — not tier or projection.
+ *
+ * This interface was referenced by `SPOKECommonTypes`'s JSON-Schema
+ * via the `definition` "TimelineScale".
+ */
+type TimelineScale = string;
+/**
+ * Opaque world-history branch identity (l5-fork).
+ *
+ * This interface was referenced by `SPOKECommonTypes`'s JSON-Schema
+ * via the `definition` "ForkId".
+ */
+type ForkId = string;
+/**
+ * Shared type definitions for SPOKE wire schemas.
+ */
+interface SPOKECommonTypes {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ *
+ * This interface was referenced by `SPOKECommonTypes`'s JSON-Schema
+ * via the `definition` "ExtensionMap".
+ */
+interface ExtensionMap$m {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * This interface was referenced by `SPOKECommonTypes`'s JSON-Schema
+ * via the `definition` "SourceSpan".
+ */
+interface SourceSpan$b {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * This interface was referenced by `SPOKECommonTypes`'s JSON-Schema
+ * via the `definition` "Scope".
+ */
+interface Scope$2 {
+    /**
+     * Protocol-neutral opaque selector. Products map World/Book/chapter/manuscript ids via adapters or op extensions.
+     */
+    scope_id: string;
+    /**
+     * Optional narrow scope to explicit KnowledgeEntries.
+     */
+    entry_ids?: string[];
+    /**
+     * Optional filter by open entry_type vocabulary.
+     */
+    entry_types?: string[];
+    /**
+     * Optional narrow scope to explicit L5 TimelineEvent ids.
+     */
+    timeline_event_ids?: string[];
+    /**
+     * Optional provenance or manuscript locator scope.
+     */
+    source_id?: string;
+    /**
+     * Optional L5 tier filter (brief, narrative, moment).
+     */
+    timeline_scale?: string;
+    /**
+     * Optional L5 branch filter — strict equality on TimelineEvent.fork_id (l5-fork).
+     */
+    fork_id?: string;
+}
+/**
+ * Open map of product-owned computable field names to domain values. Shared by KnowledgeEntry body.state and body.computable under l2-computable. Protocol does not require WASM bytecode or executable artifacts.
+ *
+ * This interface was referenced by `SPOKECommonTypes`'s JSON-Schema
+ * via the `definition` "ComputableFieldMap".
+ */
+interface ComputableFieldMap$9 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * This interface was referenced by `SPOKECommonTypes`'s JSON-Schema
+ * via the `definition` "ComputableLogChange".
+ */
+interface ComputableLogChange$1 {
+    /**
+     * Dot-path or JSON Pointer to changed field within body.computable.
+     */
+    path: string;
+    /**
+     * Opaque JSON — value before change.
+     */
+    previous?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Opaque JSON — value after change.
+     */
+    next?: {
+        [k: string]: unknown | undefined;
+    };
+}
+/**
+ * This interface was referenced by `SPOKECommonTypes`'s JSON-Schema
+ * via the `definition` "ComputableLogEntry".
+ */
+interface ComputableLogEntry$1 {
+    /**
+     * When the computable field change was recorded (RFC 3339).
+     */
+    logged_at: string;
+    /**
+     * KnowledgeEntry id whose computable fields changed.
+     */
+    entry_id: string;
+    /**
+     * Field-level change records within body.computable.
+     */
+    changes: ComputableLogChange$1[];
+    /**
+     * Opaque Session correlation (matches op session_id when omitted on parent context).
+     */
+    session_id?: string;
+    /**
+     * Human-readable presentation note (presentation only).
+     */
+    message?: string;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Shared ops error shape. Ops responses use either a success payload or a top-level error field — not both.
+ */
+interface ErrorEnvelope$7 {
+    /**
+     * Machine-readable error code.
+     */
+    code: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional structured error context.
+     */
+    details?: {
+        [k: string]: unknown | undefined;
+    };
+    extensions: ExtensionMap$l;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$l {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Wire-only context-assembly payload. No ranking, retrieval, or token-budget fields in v0.1.
+ */
+interface AssemblePacket$1 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable packet id.
+     */
+    packet_id: string;
+    /**
+     * Slim context entries (default). Full KnowledgeEntry embedding is op-specific.
+     */
+    entries: AssembleEntry$1[];
+    extensions: ExtensionMap$k;
+}
+/**
+ * This interface was referenced by `AssemblePacket`'s JSON-Schema
+ * via the `definition` "AssembleEntry".
+ */
+interface AssembleEntry$1 {
+    /**
+     * Referenced KnowledgeEntry id.
+     */
+    entry_id: string;
+    /**
+     * Open string. Same core vocabulary as KnowledgeEntry.entry_type.
+     */
+    entry_type: string;
+    /**
+     * Display name for context window.
+     */
+    canonical_name: string;
+    /**
+     * Optional trimmed text for context window.
+     */
+    snippet?: string;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$k {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Checker output — not a KnowledgeEntry body.
+ */
+interface Finding$1 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable finding id.
+     */
+    finding_id: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): info, warning, error.
+     */
+    severity: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): open, resolved, dismissed.
+     */
+    status: string;
+    /**
+     * Short finding title.
+     */
+    title: string;
+    /**
+     * Finding detail text.
+     */
+    description: string;
+    /**
+     * Optional checker kind or category.
+     */
+    kind?: string;
+    /**
+     * Optional KnowledgeEntry the finding targets.
+     */
+    target_entry_id?: string;
+    source_anchor?: SourceAnchor$a;
+    /**
+     * Optional suggested remediation text.
+     */
+    suggested_fix?: string;
+    /**
+     * Optional position hint within source text.
+     */
+    text_position?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$j;
+}
+/**
+ * Optional provenance pointer.
+ */
+interface SourceAnchor$a {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Opaque source locator; products define grammar.
+     */
+    source_id: string;
+    span?: SourceSpan$a;
+    /**
+     * Optional human label for the anchor.
+     */
+    label?: string;
+    /**
+     * Optional MIME type of the referenced source.
+     */
+    mime_type?: string;
+    extensions: ExtensionMap$j;
+}
+/**
+ * Optional byte or character span within the source.
+ */
+interface SourceSpan$a {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$j {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Atomic narrative knowledge unit: identity, typed body, provenance envelope.
+ */
+interface KnowledgeEntry$4 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable KnowledgeEntry id (opaque to protocol).
+     */
+    entry_id: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): character, location, event (ontology label; ≠ TimelineEvent wire object), scene, act, organization, item, conflict, info_point, era, worldbuilding, note, research, ability, rule (ontology label; ≠ L6 Rule wire object). Products MAY emit values outside this list.
+     */
+    entry_type: string;
+    /**
+     * Human-stable name.
+     */
+    canonical_name: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): provisional, confirmed, deprecated, merged, deleted.
+     */
+    status: string;
+    /**
+     * Structured payload. Typed attributes (summary, tags, attributes) live here — not as protocol siblings. Under l2-computable: optional state (static durable computable) and computable (dynamic Session-scoped projection).
+     */
+    body: {
+        state?: ComputableFieldMap$8;
+        computable?: ComputableFieldMap1$5;
+        [k: string]: unknown | undefined;
+    };
+    source_anchor?: SourceAnchor$9;
+    /**
+     * Optimistic concurrency revision.
+     */
+    revision?: number;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$i;
+}
+/**
+ * Static durable computable state (l2-computable optional). Authoritative pre-Session and after settle.
+ */
+interface ComputableFieldMap$8 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Dynamic Session-scoped computable projection (l2-computable optional). Absent or inert pre-Session; mutates mid-Session only.
+ */
+interface ComputableFieldMap1$5 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Optional provenance pointer.
+ */
+interface SourceAnchor$9 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Opaque source locator; products define grammar.
+     */
+    source_id: string;
+    span?: SourceSpan$9;
+    /**
+     * Optional human label for the anchor.
+     */
+    label?: string;
+    /**
+     * Optional MIME type of the referenced source.
+     */
+    mime_type?: string;
+    extensions: ExtensionMap$i;
+}
+/**
+ * Optional byte or character span within the source.
+ */
+interface SourceSpan$9 {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$i {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Directed edge between two KnowledgeEntries (or KnowledgeEntry and source anchor).
+ */
+interface Relation$2 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable relation id.
+     */
+    relation_id: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): related_to, parent_of, member_of, located_in, participates_in, causes, foreshadows.
+     */
+    relation_type: string;
+    /**
+     * Source endpoint id (KnowledgeEntry or anchor id).
+     */
+    from_id: string;
+    /**
+     * Target endpoint id (KnowledgeEntry or anchor id).
+     */
+    to_id: string;
+    /**
+     * Optional human label.
+     */
+    label?: string;
+    /**
+     * Optional open metadata bag.
+     */
+    metadata?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$h;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$h {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Declarative constraint input to check — never checker output.
+ */
+interface Rule$1 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable rule id (opaque to protocol).
+     */
+    rule_id: string;
+    /**
+     * Human-stable name.
+     */
+    canonical_name: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): rule, prohibition, style.
+     */
+    kind: string;
+    /**
+     * Declarative constraint text (human- or machine-readable; products choose grammar).
+     */
+    statement?: string;
+    /**
+     * Longer explanation for integrators or authors.
+     */
+    description?: string;
+    /**
+     * Optional ontology filter — open strings matching KnowledgeEntry entry_type vocabulary.
+     */
+    target_entry_types?: string[];
+    /**
+     * Optional checker hint. Core vocabulary (documented, not enforced): info, warning, error.
+     */
+    severity_hint?: string;
+    source_anchor?: SourceAnchor$8;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): draft, active, deprecated.
+     */
+    status?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$g;
+}
+/**
+ * Optional provenance pointer when rule is anchored to manuscript.
+ */
+interface SourceAnchor$8 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Opaque source locator; products define grammar.
+     */
+    source_id: string;
+    span?: SourceSpan$8;
+    /**
+     * Optional human label for the anchor.
+     */
+    label?: string;
+    /**
+     * Optional MIME type of the referenced source.
+     */
+    mime_type?: string;
+    extensions: ExtensionMap$g;
+}
+/**
+ * Optional byte or character span within the source.
+ */
+interface SourceSpan$8 {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$g {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Pointer to a source artifact span (manuscript, scene, external URI).
+ */
+interface SourceAnchor$7 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Opaque source locator; products define grammar.
+     */
+    source_id: string;
+    span?: SourceSpan$7;
+    /**
+     * Optional human label for the anchor.
+     */
+    label?: string;
+    /**
+     * Optional MIME type of the referenced source.
+     */
+    mime_type?: string;
+    extensions: ExtensionMap$f;
+}
+/**
+ * Optional byte or character span within the source.
+ */
+interface SourceSpan$7 {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$f {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * First-class when-axis temporal object (L5). Distinct from KnowledgeEntry ontology labels such as entry_type: "event" (KB fact node, not this wire type).
+ */
+interface TimelineEvent {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable TimelineEvent id (opaque to protocol).
+     */
+    timeline_event_id: string;
+    /**
+     * Human-stable label.
+     */
+    canonical_name: string;
+    /**
+     * Optional L5 projection tier (brief, narrative, moment).
+     */
+    timeline_scale?: string;
+    /**
+     * When the event happened — RFC 3339 or opaque fuzzy label (e.g. Third Age).
+     */
+    occurred_at?: string;
+    /**
+     * Longer narrative summary.
+     */
+    description?: string;
+    /**
+     * Related KnowledgeEntry ids (characters, locations, etc.).
+     */
+    participant_entry_ids?: string[];
+    source_anchor?: SourceAnchor$6;
+    /**
+     * Opaque ordering hint within a timeline (products define grammar).
+     */
+    sort_key?: string;
+    /**
+     * Optional world-history branch identity (l5-fork).
+     */
+    fork_id?: string;
+    /**
+     * Optional parent/base branch reference when product records fork lineage on the event.
+     */
+    parent_fork_id?: string;
+    /**
+     * Optional Moment-scale presentation of computable field change history (l2-computable only). Not Finding-shaped.
+     */
+    computable_logs?: ComputableLogEntry[];
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$e;
+}
+/**
+ * Optional manuscript or scene anchor.
+ */
+interface SourceAnchor$6 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Opaque source locator; products define grammar.
+     */
+    source_id: string;
+    span?: SourceSpan$6;
+    /**
+     * Optional human label for the anchor.
+     */
+    label?: string;
+    /**
+     * Optional MIME type of the referenced source.
+     */
+    mime_type?: string;
+    extensions: ExtensionMap$e;
+}
+/**
+ * Optional byte or character span within the source.
+ */
+interface SourceSpan$6 {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$e {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+interface ComputableLogEntry {
+    /**
+     * When the computable field change was recorded (RFC 3339).
+     */
+    logged_at: string;
+    /**
+     * KnowledgeEntry id whose computable fields changed.
+     */
+    entry_id: string;
+    /**
+     * Field-level change records within body.computable.
+     */
+    changes: ComputableLogChange[];
+    /**
+     * Opaque Session correlation (matches op session_id when omitted on parent context).
+     */
+    session_id?: string;
+    /**
+     * Human-readable presentation note (presentation only).
+     */
+    message?: string;
+}
+interface ComputableLogChange {
+    /**
+     * Dot-path or JSON Pointer to changed field within body.computable.
+     */
+    path: string;
+    /**
+     * Opaque JSON — value before change.
+     */
+    previous?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Opaque JSON — value after change.
+     */
+    next?: {
+        [k: string]: unknown | undefined;
+    };
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Selector hints for context assembly. Wire-only — no compute semantics.
+ */
+interface AssembleRequest {
+    scope: Scope$1;
+    /**
+     * Optional entry limit hint (not enforced by protocol).
+     */
+    max_entries?: number;
+    extensions?: ExtensionMap$d;
+}
+/**
+ * Assembly scope selector.
+ */
+interface Scope$1 {
+    /**
+     * Protocol-neutral opaque selector. Products map World/Book/chapter/manuscript ids via adapters or op extensions.
+     */
+    scope_id: string;
+    /**
+     * Optional narrow scope to explicit KnowledgeEntries.
+     */
+    entry_ids?: string[];
+    /**
+     * Optional filter by open entry_type vocabulary.
+     */
+    entry_types?: string[];
+    /**
+     * Optional narrow scope to explicit L5 TimelineEvent ids.
+     */
+    timeline_event_ids?: string[];
+    /**
+     * Optional provenance or manuscript locator scope.
+     */
+    source_id?: string;
+    /**
+     * Optional L5 tier filter (brief, narrative, moment).
+     */
+    timeline_scale?: string;
+    /**
+     * Optional L5 branch filter — strict equality on TimelineEvent.fork_id (l5-fork).
+     */
+    fork_id?: string;
+}
+/**
+ * Optional transport metadata.
+ */
+interface ExtensionMap$d {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Assemble success packet or wire error. Use packet OR error — not both.
+ */
+type AssembleResponse = {
+    packet: AssemblePacket;
+    extensions?: ExtensionMap1$a;
+} | {
+    error: ErrorEnvelope$6;
+    extensions?: ExtensionMap2$6;
+};
+/**
+ * Success: assembled context packet.
+ */
+interface AssemblePacket {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable packet id.
+     */
+    packet_id: string;
+    /**
+     * Slim context entries (default). Full KnowledgeEntry embedding is op-specific.
+     */
+    entries: AssembleEntry[];
+    extensions: ExtensionMap$c;
+}
+/**
+ * This interface was referenced by `AssemblePacket`'s JSON-Schema
+ * via the `definition` "AssembleEntry".
+ */
+interface AssembleEntry {
+    /**
+     * Referenced KnowledgeEntry id.
+     */
+    entry_id: string;
+    /**
+     * Open string. Same core vocabulary as KnowledgeEntry.entry_type.
+     */
+    entry_type: string;
+    /**
+     * Display name for context window.
+     */
+    canonical_name: string;
+    /**
+     * Optional trimmed text for context window.
+     */
+    snippet?: string;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$c {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap1$a {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Failure: shared error envelope.
+ */
+interface ErrorEnvelope$6 {
+    /**
+     * Machine-readable error code.
+     */
+    code: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional structured error context.
+     */
+    details?: {
+        [k: string]: unknown | undefined;
+    };
+    extensions: ExtensionMap$c;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap2$6 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Run checker(s) over a scope; returns Finding(s).
+ */
+interface CheckRequest {
+    scope: Scope;
+    /**
+     * Opaque rule ids or URIs. Resolved by receiver when not overridden by rules[].
+     */
+    rule_refs?: string[];
+    /**
+     * Optional embedded Rule objects for portable interchange.
+     */
+    rules?: Rule[];
+    /**
+     * Optional checker kind filters.
+     */
+    checker_kinds?: string[];
+    extensions?: ExtensionMap1$9;
+}
+/**
+ * Checker scope selector.
+ */
+interface Scope {
+    /**
+     * Protocol-neutral opaque selector. Products map World/Book/chapter/manuscript ids via adapters or op extensions.
+     */
+    scope_id: string;
+    /**
+     * Optional narrow scope to explicit KnowledgeEntries.
+     */
+    entry_ids?: string[];
+    /**
+     * Optional filter by open entry_type vocabulary.
+     */
+    entry_types?: string[];
+    /**
+     * Optional narrow scope to explicit L5 TimelineEvent ids.
+     */
+    timeline_event_ids?: string[];
+    /**
+     * Optional provenance or manuscript locator scope.
+     */
+    source_id?: string;
+    /**
+     * Optional L5 tier filter (brief, narrative, moment).
+     */
+    timeline_scale?: string;
+    /**
+     * Optional L5 branch filter — strict equality on TimelineEvent.fork_id (l5-fork).
+     */
+    fork_id?: string;
+}
+/**
+ * Declarative constraint input to check — never checker output.
+ */
+interface Rule {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable rule id (opaque to protocol).
+     */
+    rule_id: string;
+    /**
+     * Human-stable name.
+     */
+    canonical_name: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): rule, prohibition, style.
+     */
+    kind: string;
+    /**
+     * Declarative constraint text (human- or machine-readable; products choose grammar).
+     */
+    statement?: string;
+    /**
+     * Longer explanation for integrators or authors.
+     */
+    description?: string;
+    /**
+     * Optional ontology filter — open strings matching KnowledgeEntry entry_type vocabulary.
+     */
+    target_entry_types?: string[];
+    /**
+     * Optional checker hint. Core vocabulary (documented, not enforced): info, warning, error.
+     */
+    severity_hint?: string;
+    source_anchor?: SourceAnchor$5;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): draft, active, deprecated.
+     */
+    status?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$b;
+}
+/**
+ * Optional provenance pointer when rule is anchored to manuscript.
+ */
+interface SourceAnchor$5 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Opaque source locator; products define grammar.
+     */
+    source_id: string;
+    span?: SourceSpan$5;
+    /**
+     * Optional human label for the anchor.
+     */
+    label?: string;
+    /**
+     * Optional MIME type of the referenced source.
+     */
+    mime_type?: string;
+    extensions: ExtensionMap$b;
+}
+/**
+ * Optional byte or character span within the source.
+ */
+interface SourceSpan$5 {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$b {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap1$9 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Checker findings or wire error. Use findings OR error — not both.
+ */
+type CheckResponse = {
+    /**
+     * Success: checker output findings.
+     */
+    findings: Finding[];
+    extensions?: ExtensionMap1$8;
+} | {
+    error: ErrorEnvelope$5;
+    extensions?: ExtensionMap2$5;
+};
+/**
+ * Checker output — not a KnowledgeEntry body.
+ */
+interface Finding {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable finding id.
+     */
+    finding_id: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): info, warning, error.
+     */
+    severity: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): open, resolved, dismissed.
+     */
+    status: string;
+    /**
+     * Short finding title.
+     */
+    title: string;
+    /**
+     * Finding detail text.
+     */
+    description: string;
+    /**
+     * Optional checker kind or category.
+     */
+    kind?: string;
+    /**
+     * Optional KnowledgeEntry the finding targets.
+     */
+    target_entry_id?: string;
+    source_anchor?: SourceAnchor$4;
+    /**
+     * Optional suggested remediation text.
+     */
+    suggested_fix?: string;
+    /**
+     * Optional position hint within source text.
+     */
+    text_position?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$a;
+}
+/**
+ * Optional provenance pointer.
+ */
+interface SourceAnchor$4 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Opaque source locator; products define grammar.
+     */
+    source_id: string;
+    span?: SourceSpan$4;
+    /**
+     * Optional human label for the anchor.
+     */
+    label?: string;
+    /**
+     * Optional MIME type of the referenced source.
+     */
+    mime_type?: string;
+    extensions: ExtensionMap$a;
+}
+/**
+ * Optional byte or character span within the source.
+ */
+interface SourceSpan$4 {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$a {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap1$8 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Failure: shared error envelope.
+ */
+interface ErrorEnvelope$5 {
+    /**
+     * Machine-readable error code.
+     */
+    code: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional structured error context.
+     */
+    details?: {
+        [k: string]: unknown | undefined;
+    };
+    extensions: ExtensionMap$a;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap2$5 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Apply / settle I/O — carry computable updates; merge to static state when settle is true.
+ */
+interface ComputeRequest {
+    /**
+     * Opaque Session correlation id. Products own Session stores.
+     */
+    session_id: string;
+    /**
+     * Target KnowledgeEntry id.
+     */
+    entry_id: string;
+    computable: ComputableFieldMap$7;
+    /**
+     * When true, product merges computable into static state at Session end. Defaults to false when omitted.
+     */
+    settle?: boolean;
+    extensions?: ExtensionMap$9;
+}
+/**
+ * Session-scoped dynamic computable payload (body.computable).
+ */
+interface ComputableFieldMap$7 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Optional transport metadata.
+ */
+interface ExtensionMap$9 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Updated computable view (and merged static state when settle was true) or wire error. Use session_id, entry_id, and computable OR error — not both.
+ */
+type ComputeResponse = {
+    /**
+     * Echo of request Session correlation id.
+     */
+    session_id: string;
+    /**
+     * Target KnowledgeEntry id.
+     */
+    entry_id: string;
+    computable: ComputableFieldMap$6;
+    state?: ComputableFieldMap1$4;
+    extensions?: ExtensionMap$8;
+} | {
+    error: ErrorEnvelope$4;
+    extensions?: ExtensionMap2$4;
+};
+/**
+ * Success: updated dynamic computable view.
+ */
+interface ComputableFieldMap$6 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Merged static state after settle. Products MUST include when request settle was true.
+ */
+interface ComputableFieldMap1$4 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Optional transport metadata.
+ */
+interface ExtensionMap$8 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Failure: shared error envelope.
+ */
+interface ErrorEnvelope$4 {
+    /**
+     * Machine-readable error code.
+     */
+    code: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional structured error context.
+     */
+    details?: {
+        [k: string]: unknown | undefined;
+    };
+    extensions: ExtensionMap1$7;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap1$7 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap2$4 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Init / projection — materialize Session dynamic computable view from static state.
+ */
+interface ProjectRequest {
+    /**
+     * Opaque Session correlation id. Products own Session stores.
+     */
+    session_id: string;
+    /**
+     * Target KnowledgeEntry id.
+     */
+    entry_id: string;
+    state: ComputableFieldMap$5;
+    extensions?: ExtensionMap$7;
+}
+/**
+ * Static computable source (body.state).
+ */
+interface ComputableFieldMap$5 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Optional transport metadata.
+ */
+interface ExtensionMap$7 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Projected computable view or wire error. Use session_id, entry_id, and computable OR error — not both.
+ */
+type ProjectResponse = {
+    /**
+     * Echo of request Session correlation id.
+     */
+    session_id: string;
+    /**
+     * Target KnowledgeEntry id.
+     */
+    entry_id: string;
+    computable: ComputableFieldMap$4;
+    extensions?: ExtensionMap$6;
+} | {
+    error: ErrorEnvelope$3;
+    extensions?: ExtensionMap2$3;
+};
+/**
+ * Success: materialized dynamic computable view (body.computable).
+ */
+interface ComputableFieldMap$4 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Optional transport metadata.
+ */
+interface ExtensionMap$6 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Failure: shared error envelope.
+ */
+interface ErrorEnvelope$3 {
+    /**
+     * Machine-readable error code.
+     */
+    code: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional structured error context.
+     */
+    details?: {
+        [k: string]: unknown | undefined;
+    };
+    extensions: ExtensionMap1$6;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap1$6 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap2$3 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Extract-to-promote: promote a candidate KnowledgeEntry to durable storage.
+ */
+interface PromoteRequest {
+    candidate: KnowledgeEntry$3;
+    /**
+     * Optional merge target KnowledgeEntry id.
+     */
+    target_entry_id?: string;
+    extensions?: ExtensionMap1$5;
+}
+/**
+ * Candidate KnowledgeEntry (typically status provisional).
+ */
+interface KnowledgeEntry$3 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable KnowledgeEntry id (opaque to protocol).
+     */
+    entry_id: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): character, location, event (ontology label; ≠ TimelineEvent wire object), scene, act, organization, item, conflict, info_point, era, worldbuilding, note, research, ability, rule (ontology label; ≠ L6 Rule wire object). Products MAY emit values outside this list.
+     */
+    entry_type: string;
+    /**
+     * Human-stable name.
+     */
+    canonical_name: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): provisional, confirmed, deprecated, merged, deleted.
+     */
+    status: string;
+    /**
+     * Structured payload. Typed attributes (summary, tags, attributes) live here — not as protocol siblings. Under l2-computable: optional state (static durable computable) and computable (dynamic Session-scoped projection).
+     */
+    body: {
+        state?: ComputableFieldMap$3;
+        computable?: ComputableFieldMap1$3;
+        [k: string]: unknown | undefined;
+    };
+    source_anchor?: SourceAnchor$3;
+    /**
+     * Optimistic concurrency revision.
+     */
+    revision?: number;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$5;
+}
+/**
+ * Static durable computable state (l2-computable optional). Authoritative pre-Session and after settle.
+ */
+interface ComputableFieldMap$3 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Dynamic Session-scoped computable projection (l2-computable optional). Absent or inert pre-Session; mutates mid-Session only.
+ */
+interface ComputableFieldMap1$3 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Optional provenance pointer.
+ */
+interface SourceAnchor$3 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Opaque source locator; products define grammar.
+     */
+    source_id: string;
+    span?: SourceSpan$3;
+    /**
+     * Optional human label for the anchor.
+     */
+    label?: string;
+    /**
+     * Optional MIME type of the referenced source.
+     */
+    mime_type?: string;
+    extensions: ExtensionMap$5;
+}
+/**
+ * Optional byte or character span within the source.
+ */
+interface SourceSpan$3 {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$5 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap1$5 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Promoted KnowledgeEntry or wire error. Use knowledge_entry OR error — not both.
+ */
+type PromoteResponse = {
+    knowledge_entry: KnowledgeEntry$2;
+    /**
+     * Optional id of KnowledgeEntry superseded during merge.
+     */
+    superseded_id?: string;
+    extensions?: ExtensionMap1$4;
+} | {
+    error: ErrorEnvelope$2;
+    extensions?: ExtensionMap2$2;
+};
+/**
+ * Success: promoted KnowledgeEntry.
+ */
+interface KnowledgeEntry$2 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable KnowledgeEntry id (opaque to protocol).
+     */
+    entry_id: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): character, location, event (ontology label; ≠ TimelineEvent wire object), scene, act, organization, item, conflict, info_point, era, worldbuilding, note, research, ability, rule (ontology label; ≠ L6 Rule wire object). Products MAY emit values outside this list.
+     */
+    entry_type: string;
+    /**
+     * Human-stable name.
+     */
+    canonical_name: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): provisional, confirmed, deprecated, merged, deleted.
+     */
+    status: string;
+    /**
+     * Structured payload. Typed attributes (summary, tags, attributes) live here — not as protocol siblings. Under l2-computable: optional state (static durable computable) and computable (dynamic Session-scoped projection).
+     */
+    body: {
+        state?: ComputableFieldMap$2;
+        computable?: ComputableFieldMap1$2;
+        [k: string]: unknown | undefined;
+    };
+    source_anchor?: SourceAnchor$2;
+    /**
+     * Optimistic concurrency revision.
+     */
+    revision?: number;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$4;
+}
+/**
+ * Static durable computable state (l2-computable optional). Authoritative pre-Session and after settle.
+ */
+interface ComputableFieldMap$2 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Dynamic Session-scoped computable projection (l2-computable optional). Absent or inert pre-Session; mutates mid-Session only.
+ */
+interface ComputableFieldMap1$2 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Optional provenance pointer.
+ */
+interface SourceAnchor$2 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Opaque source locator; products define grammar.
+     */
+    source_id: string;
+    span?: SourceSpan$2;
+    /**
+     * Optional human label for the anchor.
+     */
+    label?: string;
+    /**
+     * Optional MIME type of the referenced source.
+     */
+    mime_type?: string;
+    extensions: ExtensionMap$4;
+}
+/**
+ * Optional byte or character span within the source.
+ */
+interface SourceSpan$2 {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$4 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap1$4 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Failure: shared error envelope.
+ */
+interface ErrorEnvelope$2 {
+    /**
+     * Machine-readable error code.
+     */
+    code: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional structured error context.
+     */
+    details?: {
+        [k: string]: unknown | undefined;
+    };
+    extensions: ExtensionMap$4;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap2$2 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Create or update a Relation.
+ */
+interface RelateRequest {
+    relation: Relation$1;
+    extensions?: ExtensionMap1$3;
+}
+/**
+ * Relation to create or update.
+ */
+interface Relation$1 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable relation id.
+     */
+    relation_id: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): related_to, parent_of, member_of, located_in, participates_in, causes, foreshadows.
+     */
+    relation_type: string;
+    /**
+     * Source endpoint id (KnowledgeEntry or anchor id).
+     */
+    from_id: string;
+    /**
+     * Target endpoint id (KnowledgeEntry or anchor id).
+     */
+    to_id: string;
+    /**
+     * Optional human label.
+     */
+    label?: string;
+    /**
+     * Optional open metadata bag.
+     */
+    metadata?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$3;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$3 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap1$3 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Persisted Relation or wire error. Use relation OR error — not both.
+ */
+type RelateResponse = {
+    relation: Relation;
+    extensions?: ExtensionMap1$2;
+} | {
+    error: ErrorEnvelope$1;
+    extensions?: ExtensionMap2$1;
+};
+/**
+ * Success: persisted Relation.
+ */
+interface Relation {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable relation id.
+     */
+    relation_id: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): related_to, parent_of, member_of, located_in, participates_in, causes, foreshadows.
+     */
+    relation_type: string;
+    /**
+     * Source endpoint id (KnowledgeEntry or anchor id).
+     */
+    from_id: string;
+    /**
+     * Target endpoint id (KnowledgeEntry or anchor id).
+     */
+    to_id: string;
+    /**
+     * Optional human label.
+     */
+    label?: string;
+    /**
+     * Optional open metadata bag.
+     */
+    metadata?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$2;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$2 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap1$2 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Failure: shared error envelope.
+ */
+interface ErrorEnvelope$1 {
+    /**
+     * Machine-readable error code.
+     */
+    code: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional structured error context.
+     */
+    details?: {
+        [k: string]: unknown | undefined;
+    };
+    extensions: ExtensionMap$2;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap2$1 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Create or update one or more KnowledgeEntries by stable id.
+ */
+interface UpsertRequest {
+    /**
+     * KnowledgeEntries to create or update.
+     *
+     * @minItems 1
+     */
+    knowledge_entries: [KnowledgeEntry$1, ...KnowledgeEntry$1[]];
+    /**
+     * Opaque idempotency hint (no server semantics in v0.1).
+     */
+    idempotency_key?: string;
+    extensions?: ExtensionMap1$1;
+}
+/**
+ * Atomic narrative knowledge unit: identity, typed body, provenance envelope.
+ */
+interface KnowledgeEntry$1 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable KnowledgeEntry id (opaque to protocol).
+     */
+    entry_id: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): character, location, event (ontology label; ≠ TimelineEvent wire object), scene, act, organization, item, conflict, info_point, era, worldbuilding, note, research, ability, rule (ontology label; ≠ L6 Rule wire object). Products MAY emit values outside this list.
+     */
+    entry_type: string;
+    /**
+     * Human-stable name.
+     */
+    canonical_name: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): provisional, confirmed, deprecated, merged, deleted.
+     */
+    status: string;
+    /**
+     * Structured payload. Typed attributes (summary, tags, attributes) live here — not as protocol siblings. Under l2-computable: optional state (static durable computable) and computable (dynamic Session-scoped projection).
+     */
+    body: {
+        state?: ComputableFieldMap$1;
+        computable?: ComputableFieldMap1$1;
+        [k: string]: unknown | undefined;
+    };
+    source_anchor?: SourceAnchor$1;
+    /**
+     * Optimistic concurrency revision.
+     */
+    revision?: number;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap$1;
+}
+/**
+ * Static durable computable state (l2-computable optional). Authoritative pre-Session and after settle.
+ */
+interface ComputableFieldMap$1 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Dynamic Session-scoped computable projection (l2-computable optional). Absent or inert pre-Session; mutates mid-Session only.
+ */
+interface ComputableFieldMap1$1 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Optional provenance pointer.
+ */
+interface SourceAnchor$1 {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Opaque source locator; products define grammar.
+     */
+    source_id: string;
+    span?: SourceSpan$1;
+    /**
+     * Optional human label for the anchor.
+     */
+    label?: string;
+    /**
+     * Optional MIME type of the referenced source.
+     */
+    mime_type?: string;
+    extensions: ExtensionMap$1;
+}
+/**
+ * Optional byte or character span within the source.
+ */
+interface SourceSpan$1 {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap$1 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap1$1 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+/**
+ * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
+ * Source: schemas/
+ * Generated by: pnpm run codegen
+ */
+/**
+ * Persisted KnowledgeEntry view or wire error. Use knowledge_entries OR error — not both.
+ */
+type UpsertResponse = {
+    /**
+     * Success: persisted KnowledgeEntries.
+     */
+    knowledge_entries: KnowledgeEntry[];
+    /**
+     * Optional per-KnowledgeEntry rejections (success branch only).
+     */
+    rejected?: UpsertRejected[];
+    extensions?: ExtensionMap1;
+} | {
+    error: ErrorEnvelope;
+    extensions?: ExtensionMap2;
+};
+/**
+ * Atomic narrative knowledge unit: identity, typed body, provenance envelope.
+ */
+interface KnowledgeEntry {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Stable KnowledgeEntry id (opaque to protocol).
+     */
+    entry_id: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): character, location, event (ontology label; ≠ TimelineEvent wire object), scene, act, organization, item, conflict, info_point, era, worldbuilding, note, research, ability, rule (ontology label; ≠ L6 Rule wire object). Products MAY emit values outside this list.
+     */
+    entry_type: string;
+    /**
+     * Human-stable name.
+     */
+    canonical_name: string;
+    /**
+     * Open string. Core vocabulary (documented, not enforced): provisional, confirmed, deprecated, merged, deleted.
+     */
+    status: string;
+    /**
+     * Structured payload. Typed attributes (summary, tags, attributes) live here — not as protocol siblings. Under l2-computable: optional state (static durable computable) and computable (dynamic Session-scoped projection).
+     */
+    body: {
+        state?: ComputableFieldMap;
+        computable?: ComputableFieldMap1;
+        [k: string]: unknown | undefined;
+    };
+    source_anchor?: SourceAnchor;
+    /**
+     * Optimistic concurrency revision.
+     */
+    revision?: number;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    created_at?: string;
+    /**
+     * RFC 3339 UTC datetime string.
+     */
+    updated_at?: string;
+    extensions: ExtensionMap;
+}
+/**
+ * Static durable computable state (l2-computable optional). Authoritative pre-Session and after settle.
+ */
+interface ComputableFieldMap {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Dynamic Session-scoped computable projection (l2-computable optional). Absent or inert pre-Session; mutates mid-Session only.
+ */
+interface ComputableFieldMap1 {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Optional provenance pointer.
+ */
+interface SourceAnchor {
+    /**
+     * Wire schema version (integer >= 1).
+     */
+    schema_version: number;
+    /**
+     * Opaque source locator; products define grammar.
+     */
+    source_id: string;
+    span?: SourceSpan;
+    /**
+     * Optional human label for the anchor.
+     */
+    label?: string;
+    /**
+     * Optional MIME type of the referenced source.
+     */
+    mime_type?: string;
+    extensions: ExtensionMap;
+}
+/**
+ * Optional byte or character span within the source.
+ */
+interface SourceSpan {
+    /**
+     * Start offset (inclusive).
+     */
+    start: number;
+    /**
+     * End offset (exclusive).
+     */
+    end: number;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+interface UpsertRejected {
+    /**
+     * Rejected KnowledgeEntry id.
+     */
+    entry_id: string;
+    /**
+     * Machine-readable rejection code.
+     */
+    code: string;
+    /**
+     * Human-readable rejection message.
+     */
+    message: string;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap1 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+/**
+ * Failure: shared error envelope.
+ */
+interface ErrorEnvelope {
+    /**
+     * Machine-readable error code.
+     */
+    code: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional structured error context.
+     */
+    details?: {
+        [k: string]: unknown | undefined;
+    };
+    extensions: ExtensionMap;
+}
+/**
+ * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
+ */
+interface ExtensionMap2 {
+    [k: string]: {
+        [k: string]: unknown | undefined;
+    } | undefined;
+}
+
+export type { AssemblePacket$1 as AssemblePacket, AssembleRequest, AssembleResponse, CheckRequest, CheckResponse, ComputableFieldMap$9 as ComputableFieldMap, ComputableLogChange$1 as ComputableLogChange, ComputableLogEntry$1 as ComputableLogEntry, ComputeRequest, ComputeResponse, ErrorEnvelope$7 as ErrorEnvelope, ExtensionMap$m as ExtensionMap, Finding$1 as Finding, ForkId, KnowledgeEntry$4 as KnowledgeEntry, ProjectRequest, ProjectResponse, PromoteRequest, PromoteResponse, RelateRequest, RelateResponse, Relation$2 as Relation, Rule$1 as Rule, SPOKECommonTypes, SchemaVersion, Scope$2 as Scope, SourceAnchor$7 as SourceAnchor, SourceSpan$b as SourceSpan, TimelineEvent, TimelineScale, Timestamp, UpsertRequest, UpsertResponse };