@opengeni/contracts 0.44.1 → 1.0.0

package/dist/knowledge-entries.d.ts

@@ -0,0 +1,982 @@
+import { z } from "zod";
+import { AgentLearningMode } from "./agent-learning.js";
+export declare const KnowledgeEntryKind: z.ZodEnum<{
+    decision: "decision";
+    fact: "fact";
+    group: "group";
+    incident: "incident";
+    note: "note";
+    requirement: "requirement";
+    source: "source";
+}>;
+export type KnowledgeEntryKind = z.infer<typeof KnowledgeEntryKind>;
+export declare const KnowledgeEntryScope: z.ZodEnum<{
+    organization: "organization";
+    personal: "personal";
+    workspace: "workspace";
+}>;
+export type KnowledgeEntryScope = z.infer<typeof KnowledgeEntryScope>;
+/** Source-shaped location, not a second copy of the source body. */
+export declare const KnowledgeEvidenceLocation: z.ZodObject<{
+    page: z.ZodOptional<z.ZodNumber>;
+    passage: z.ZodOptional<z.ZodString>;
+    messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    path: z.ZodOptional<z.ZodString>;
+    commit: z.ZodOptional<z.ZodString>;
+    lineStart: z.ZodOptional<z.ZodNumber>;
+    lineEnd: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type KnowledgeEvidenceLocation = z.infer<typeof KnowledgeEvidenceLocation>;
+export declare const KnowledgeEntryEvidence: z.ZodObject<{
+    entryId: z.ZodUUID;
+    revisionId: z.ZodUUID;
+    location: z.ZodDefault<z.ZodObject<{
+        page: z.ZodOptional<z.ZodNumber>;
+        passage: z.ZodOptional<z.ZodString>;
+        messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        path: z.ZodOptional<z.ZodString>;
+        commit: z.ZodOptional<z.ZodString>;
+        lineStart: z.ZodOptional<z.ZodNumber>;
+        lineEnd: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    quote: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type KnowledgeEntryEvidence = z.infer<typeof KnowledgeEntryEvidence>;
+export declare const KnowledgeEntrySource: z.ZodObject<{
+    kind: z.ZodEnum<{
+        connector: "connector";
+        conversation: "conversation";
+        file: "file";
+        manual: "manual";
+        repository: "repository";
+        slack: "slack";
+        task_note: "task_note";
+        web: "web";
+    }>;
+    noteId: z.ZodOptional<z.ZodUUID>;
+    fileId: z.ZodOptional<z.ZodUUID>;
+    documentId: z.ZodOptional<z.ZodUUID>;
+    sessionId: z.ZodOptional<z.ZodUUID>;
+    uri: z.ZodOptional<z.ZodString>;
+    externalId: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    capturedAt: z.ZodOptional<z.ZodString>;
+    retention: z.ZodOptional<z.ZodEnum<{
+        full_text: "full_text";
+        passages: "passages";
+        reference: "reference";
+    }>>;
+    purpose: z.ZodOptional<z.ZodEnum<{
+        evidence: "evidence";
+        reference: "reference";
+    }>>;
+}, z.core.$strict>;
+export type KnowledgeEntrySource = z.infer<typeof KnowledgeEntrySource>;
+export declare const KnowledgeEntryRelationship: z.ZodObject<{
+    entryId: z.ZodUUID;
+    relation: z.ZodEnum<{
+        applies_to: "applies_to";
+        conflicts_with: "conflicts_with";
+        depends_on: "depends_on";
+        related_to: "related_to";
+        supersedes: "supersedes";
+    }>;
+}, z.core.$strict>;
+export type KnowledgeEntryRelationship = z.infer<typeof KnowledgeEntryRelationship>;
+export declare const KnowledgeEntryContent: z.ZodObject<{
+    title: z.ZodString;
+    kind: z.ZodEnum<{
+        decision: "decision";
+        fact: "fact";
+        group: "group";
+        incident: "incident";
+        note: "note";
+        requirement: "requirement";
+        source: "source";
+    }>;
+    content: z.ZodString;
+    source: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            connector: "connector";
+            conversation: "conversation";
+            file: "file";
+            manual: "manual";
+            repository: "repository";
+            slack: "slack";
+            task_note: "task_note";
+            web: "web";
+        }>;
+        noteId: z.ZodOptional<z.ZodUUID>;
+        fileId: z.ZodOptional<z.ZodUUID>;
+        documentId: z.ZodOptional<z.ZodUUID>;
+        sessionId: z.ZodOptional<z.ZodUUID>;
+        uri: z.ZodOptional<z.ZodString>;
+        externalId: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        capturedAt: z.ZodOptional<z.ZodString>;
+        retention: z.ZodOptional<z.ZodEnum<{
+            full_text: "full_text";
+            passages: "passages";
+            reference: "reference";
+        }>>;
+        purpose: z.ZodOptional<z.ZodEnum<{
+            evidence: "evidence";
+            reference: "reference";
+        }>>;
+    }, z.core.$strict>>;
+    evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        entryId: z.ZodUUID;
+        revisionId: z.ZodUUID;
+        location: z.ZodDefault<z.ZodObject<{
+            page: z.ZodOptional<z.ZodNumber>;
+            passage: z.ZodOptional<z.ZodString>;
+            messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            path: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            lineStart: z.ZodOptional<z.ZodNumber>;
+            lineEnd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        quote: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    groupIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+    relationships: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        entryId: z.ZodUUID;
+        relation: z.ZodEnum<{
+            applies_to: "applies_to";
+            conflicts_with: "conflicts_with";
+            depends_on: "depends_on";
+            related_to: "related_to";
+            supersedes: "supersedes";
+        }>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type KnowledgeEntryContent = z.infer<typeof KnowledgeEntryContent>;
+/** Historical relationships are lossless. Admission limits apply to new writes. */
+export declare const StoredKnowledgeEntryContent: z.ZodObject<{
+    title: z.ZodString;
+    kind: z.ZodEnum<{
+        decision: "decision";
+        fact: "fact";
+        group: "group";
+        incident: "incident";
+        note: "note";
+        requirement: "requirement";
+        source: "source";
+    }>;
+    content: z.ZodString;
+    source: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            connector: "connector";
+            conversation: "conversation";
+            file: "file";
+            manual: "manual";
+            repository: "repository";
+            slack: "slack";
+            task_note: "task_note";
+            web: "web";
+        }>;
+        noteId: z.ZodOptional<z.ZodUUID>;
+        fileId: z.ZodOptional<z.ZodUUID>;
+        documentId: z.ZodOptional<z.ZodUUID>;
+        sessionId: z.ZodOptional<z.ZodUUID>;
+        uri: z.ZodOptional<z.ZodString>;
+        externalId: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        capturedAt: z.ZodOptional<z.ZodString>;
+        retention: z.ZodOptional<z.ZodEnum<{
+            full_text: "full_text";
+            passages: "passages";
+            reference: "reference";
+        }>>;
+        purpose: z.ZodOptional<z.ZodEnum<{
+            evidence: "evidence";
+            reference: "reference";
+        }>>;
+    }, z.core.$strict>>;
+    evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        entryId: z.ZodUUID;
+        revisionId: z.ZodUUID;
+        location: z.ZodDefault<z.ZodObject<{
+            page: z.ZodOptional<z.ZodNumber>;
+            passage: z.ZodOptional<z.ZodString>;
+            messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            path: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            lineStart: z.ZodOptional<z.ZodNumber>;
+            lineEnd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        quote: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    groupIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+    relationships: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        entryId: z.ZodUUID;
+        relation: z.ZodEnum<{
+            applies_to: "applies_to";
+            conflicts_with: "conflicts_with";
+            depends_on: "depends_on";
+            related_to: "related_to";
+            supersedes: "supersedes";
+        }>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/** Scope identity and agent policy are resolved by the host, never supplied by the model. */
+export declare const KnowledgeEntrySaveRequest: z.ZodObject<{
+    operationId: z.ZodUUID;
+    entryId: z.ZodOptional<z.ZodUUID>;
+    expectedVersion: z.ZodNumber;
+    scope: z.ZodOptional<z.ZodEnum<{
+        organization: "organization";
+        personal: "personal";
+        workspace: "workspace";
+    }>>;
+    entry: z.ZodObject<{
+        kind: z.ZodEnum<{
+            decision: "decision";
+            fact: "fact";
+            group: "group";
+            incident: "incident";
+            note: "note";
+            requirement: "requirement";
+            source: "source";
+        }>;
+        content: z.ZodString;
+        source: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                connector: "connector";
+                conversation: "conversation";
+                file: "file";
+                manual: "manual";
+                repository: "repository";
+                slack: "slack";
+                task_note: "task_note";
+                web: "web";
+            }>;
+            noteId: z.ZodOptional<z.ZodUUID>;
+            fileId: z.ZodOptional<z.ZodUUID>;
+            documentId: z.ZodOptional<z.ZodUUID>;
+            sessionId: z.ZodOptional<z.ZodUUID>;
+            uri: z.ZodOptional<z.ZodString>;
+            externalId: z.ZodOptional<z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+            capturedAt: z.ZodOptional<z.ZodString>;
+            retention: z.ZodOptional<z.ZodEnum<{
+                full_text: "full_text";
+                passages: "passages";
+                reference: "reference";
+            }>>;
+            purpose: z.ZodOptional<z.ZodEnum<{
+                evidence: "evidence";
+                reference: "reference";
+            }>>;
+        }, z.core.$strict>>;
+        evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            entryId: z.ZodUUID;
+            revisionId: z.ZodUUID;
+            location: z.ZodDefault<z.ZodObject<{
+                page: z.ZodOptional<z.ZodNumber>;
+                passage: z.ZodOptional<z.ZodString>;
+                messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                path: z.ZodOptional<z.ZodString>;
+                commit: z.ZodOptional<z.ZodString>;
+                lineStart: z.ZodOptional<z.ZodNumber>;
+                lineEnd: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+            quote: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        groupIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+        relationships: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            entryId: z.ZodUUID;
+            relation: z.ZodEnum<{
+                applies_to: "applies_to";
+                conflicts_with: "conflicts_with";
+                depends_on: "depends_on";
+                related_to: "related_to";
+                supersedes: "supersedes";
+            }>;
+        }, z.core.$strict>>>;
+        title: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type KnowledgeEntrySaveRequest = z.input<typeof KnowledgeEntrySaveRequest>;
+export declare const KnowledgeTaskNotePromotionRequest: z.ZodObject<{
+    operationId: z.ZodUUID;
+    entryId: z.ZodOptional<z.ZodUUID>;
+    expectedVersion: z.ZodLiteral<0>;
+    noteId: z.ZodUUID;
+    expectedNoteVersion: z.ZodLiteral<1>;
+    title: z.ZodString;
+    groupIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+}, z.core.$strict>;
+export type KnowledgeTaskNotePromotionRequest = z.input<typeof KnowledgeTaskNotePromotionRequest>;
+export declare const KnowledgeEntryReviewRequest: z.ZodObject<{
+    operationId: z.ZodUUID;
+    entryId: z.ZodUUID;
+    revisionId: z.ZodUUID;
+    expectedVersion: z.ZodNumber;
+    decision: z.ZodEnum<{
+        approve: "approve";
+        reject: "reject";
+    }>;
+    entry: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            decision: "decision";
+            fact: "fact";
+            group: "group";
+            incident: "incident";
+            note: "note";
+            requirement: "requirement";
+            source: "source";
+        }>;
+        content: z.ZodString;
+        source: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                connector: "connector";
+                conversation: "conversation";
+                file: "file";
+                manual: "manual";
+                repository: "repository";
+                slack: "slack";
+                task_note: "task_note";
+                web: "web";
+            }>;
+            noteId: z.ZodOptional<z.ZodUUID>;
+            fileId: z.ZodOptional<z.ZodUUID>;
+            documentId: z.ZodOptional<z.ZodUUID>;
+            sessionId: z.ZodOptional<z.ZodUUID>;
+            uri: z.ZodOptional<z.ZodString>;
+            externalId: z.ZodOptional<z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+            capturedAt: z.ZodOptional<z.ZodString>;
+            retention: z.ZodOptional<z.ZodEnum<{
+                full_text: "full_text";
+                passages: "passages";
+                reference: "reference";
+            }>>;
+            purpose: z.ZodOptional<z.ZodEnum<{
+                evidence: "evidence";
+                reference: "reference";
+            }>>;
+        }, z.core.$strict>>;
+        evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            entryId: z.ZodUUID;
+            revisionId: z.ZodUUID;
+            location: z.ZodDefault<z.ZodObject<{
+                page: z.ZodOptional<z.ZodNumber>;
+                passage: z.ZodOptional<z.ZodString>;
+                messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                path: z.ZodOptional<z.ZodString>;
+                commit: z.ZodOptional<z.ZodString>;
+                lineStart: z.ZodOptional<z.ZodNumber>;
+                lineEnd: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+            quote: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        groupIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+        relationships: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            entryId: z.ZodUUID;
+            relation: z.ZodEnum<{
+                applies_to: "applies_to";
+                conflicts_with: "conflicts_with";
+                depends_on: "depends_on";
+                related_to: "related_to";
+                supersedes: "supersedes";
+            }>;
+        }, z.core.$strict>>>;
+        title: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeEntryReviewRequest = z.input<typeof KnowledgeEntryReviewRequest>;
+export declare const KnowledgeEntryBatchReviewRequest: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        operationId: z.ZodUUID;
+        entryId: z.ZodUUID;
+        revisionId: z.ZodUUID;
+        expectedVersion: z.ZodNumber;
+        decision: z.ZodEnum<{
+            approve: "approve";
+            reject: "reject";
+        }>;
+        entry: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                decision: "decision";
+                fact: "fact";
+                group: "group";
+                incident: "incident";
+                note: "note";
+                requirement: "requirement";
+                source: "source";
+            }>;
+            content: z.ZodString;
+            source: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    connector: "connector";
+                    conversation: "conversation";
+                    file: "file";
+                    manual: "manual";
+                    repository: "repository";
+                    slack: "slack";
+                    task_note: "task_note";
+                    web: "web";
+                }>;
+                noteId: z.ZodOptional<z.ZodUUID>;
+                fileId: z.ZodOptional<z.ZodUUID>;
+                documentId: z.ZodOptional<z.ZodUUID>;
+                sessionId: z.ZodOptional<z.ZodUUID>;
+                uri: z.ZodOptional<z.ZodString>;
+                externalId: z.ZodOptional<z.ZodString>;
+                version: z.ZodOptional<z.ZodString>;
+                capturedAt: z.ZodOptional<z.ZodString>;
+                retention: z.ZodOptional<z.ZodEnum<{
+                    full_text: "full_text";
+                    passages: "passages";
+                    reference: "reference";
+                }>>;
+                purpose: z.ZodOptional<z.ZodEnum<{
+                    evidence: "evidence";
+                    reference: "reference";
+                }>>;
+            }, z.core.$strict>>;
+            evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                entryId: z.ZodUUID;
+                revisionId: z.ZodUUID;
+                location: z.ZodDefault<z.ZodObject<{
+                    page: z.ZodOptional<z.ZodNumber>;
+                    passage: z.ZodOptional<z.ZodString>;
+                    messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    path: z.ZodOptional<z.ZodString>;
+                    commit: z.ZodOptional<z.ZodString>;
+                    lineStart: z.ZodOptional<z.ZodNumber>;
+                    lineEnd: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+                quote: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            groupIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+            relationships: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                entryId: z.ZodUUID;
+                relation: z.ZodEnum<{
+                    applies_to: "applies_to";
+                    conflicts_with: "conflicts_with";
+                    depends_on: "depends_on";
+                    related_to: "related_to";
+                    supersedes: "supersedes";
+                }>;
+            }, z.core.$strict>>>;
+            title: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeEntryBatchReviewRequest = z.input<typeof KnowledgeEntryBatchReviewRequest>;
+export declare const KnowledgeEntryRestoreRequest: z.ZodObject<{
+    operationId: z.ZodUUID;
+    entryId: z.ZodUUID;
+    revisionId: z.ZodUUID;
+    expectedVersion: z.ZodNumber;
+}, z.core.$strict>;
+export type KnowledgeEntryRestoreRequest = z.infer<typeof KnowledgeEntryRestoreRequest>;
+export declare const KnowledgeEntryWriteReceipt: z.ZodObject<{
+    operationId: z.ZodUUID;
+    entryId: z.ZodUUID;
+    revisionId: z.ZodUUID;
+    version: z.ZodNumber;
+    outcome: z.ZodEnum<{
+        archived: "archived";
+        pending: "pending";
+        published: "published";
+        rejected: "rejected";
+    }>;
+    reviewBatchId: z.ZodNullable<z.ZodUUID>;
+    replayed: z.ZodBoolean;
+}, z.core.$strict>;
+export type KnowledgeEntryWriteReceipt = z.infer<typeof KnowledgeEntryWriteReceipt>;
+export declare const KnowledgeFilePreparationResult: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"retained">;
+    fileId: z.ZodUUID;
+    filename: z.ZodString;
+    receipt: z.ZodObject<{
+        operationId: z.ZodUUID;
+        entryId: z.ZodUUID;
+        revisionId: z.ZodUUID;
+        version: z.ZodNumber;
+        outcome: z.ZodEnum<{
+            archived: "archived";
+            pending: "pending";
+            published: "published";
+            rejected: "rejected";
+        }>;
+        reviewBatchId: z.ZodNullable<z.ZodUUID>;
+        replayed: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    status: z.ZodLiteral<"disabled">;
+    fileId: z.ZodUUID;
+}, z.core.$strict>], "status">;
+export type KnowledgeFilePreparationResult = z.infer<typeof KnowledgeFilePreparationResult>;
+export declare const KnowledgeEntryRevision: z.ZodObject<{
+    id: z.ZodUUID;
+    entryId: z.ZodUUID;
+    number: z.ZodNumber;
+    change: z.ZodEnum<{
+        archive: "archive";
+        upsert: "upsert";
+    }>;
+    entry: z.ZodObject<{
+        title: z.ZodString;
+        kind: z.ZodEnum<{
+            decision: "decision";
+            fact: "fact";
+            group: "group";
+            incident: "incident";
+            note: "note";
+            requirement: "requirement";
+            source: "source";
+        }>;
+        content: z.ZodString;
+        source: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                connector: "connector";
+                conversation: "conversation";
+                file: "file";
+                manual: "manual";
+                repository: "repository";
+                slack: "slack";
+                task_note: "task_note";
+                web: "web";
+            }>;
+            noteId: z.ZodOptional<z.ZodUUID>;
+            fileId: z.ZodOptional<z.ZodUUID>;
+            documentId: z.ZodOptional<z.ZodUUID>;
+            sessionId: z.ZodOptional<z.ZodUUID>;
+            uri: z.ZodOptional<z.ZodString>;
+            externalId: z.ZodOptional<z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+            capturedAt: z.ZodOptional<z.ZodString>;
+            retention: z.ZodOptional<z.ZodEnum<{
+                full_text: "full_text";
+                passages: "passages";
+                reference: "reference";
+            }>>;
+            purpose: z.ZodOptional<z.ZodEnum<{
+                evidence: "evidence";
+                reference: "reference";
+            }>>;
+        }, z.core.$strict>>;
+        evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            entryId: z.ZodUUID;
+            revisionId: z.ZodUUID;
+            location: z.ZodDefault<z.ZodObject<{
+                page: z.ZodOptional<z.ZodNumber>;
+                passage: z.ZodOptional<z.ZodString>;
+                messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                path: z.ZodOptional<z.ZodString>;
+                commit: z.ZodOptional<z.ZodString>;
+                lineStart: z.ZodOptional<z.ZodNumber>;
+                lineEnd: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>>;
+            quote: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        groupIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+        relationships: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            entryId: z.ZodUUID;
+            relation: z.ZodEnum<{
+                applies_to: "applies_to";
+                conflicts_with: "conflicts_with";
+                depends_on: "depends_on";
+                related_to: "related_to";
+                supersedes: "supersedes";
+            }>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    previousRevisionId: z.ZodNullable<z.ZodUUID>;
+    restoredFromRevisionId: z.ZodNullable<z.ZodUUID>;
+    createdAt: z.ZodString;
+    createdBySessionId: z.ZodNullable<z.ZodUUID>;
+    reviewBatchId: z.ZodNullable<z.ZodUUID>;
+    outcome: z.ZodEnum<{
+        pending: "pending";
+        published: "published";
+        rejected: "rejected";
+        superseded: "superseded";
+    }>;
+}, z.core.$strict>;
+export type KnowledgeEntryRevision = z.infer<typeof KnowledgeEntryRevision>;
+/** Search/index progress is independent of saved source and keyword access. */
+export declare const KnowledgeIndexStatus: z.ZodEnum<{
+    awaiting_funding: "awaiting_funding";
+    indexed: "indexed";
+    indexing: "indexing";
+    provider_failed: "provider_failed";
+    queued: "queued";
+    saved: "saved";
+    source_unavailable: "source_unavailable";
+}>;
+export type KnowledgeIndexStatus = z.infer<typeof KnowledgeIndexStatus>;
+/** Private owner IDs are not part of a content-discovery projection. */
+export declare const KnowledgeEntryRecord: z.ZodObject<{
+    id: z.ZodUUID;
+    scope: z.ZodEnum<{
+        organization: "organization";
+        personal: "personal";
+        workspace: "workspace";
+    }>;
+    version: z.ZodNumber;
+    publishedRevisionId: z.ZodNullable<z.ZodUUID>;
+    latestRevisionId: z.ZodUUID;
+    revision: z.ZodObject<{
+        id: z.ZodUUID;
+        entryId: z.ZodUUID;
+        number: z.ZodNumber;
+        change: z.ZodEnum<{
+            archive: "archive";
+            upsert: "upsert";
+        }>;
+        entry: z.ZodObject<{
+            title: z.ZodString;
+            kind: z.ZodEnum<{
+                decision: "decision";
+                fact: "fact";
+                group: "group";
+                incident: "incident";
+                note: "note";
+                requirement: "requirement";
+                source: "source";
+            }>;
+            content: z.ZodString;
+            source: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    connector: "connector";
+                    conversation: "conversation";
+                    file: "file";
+                    manual: "manual";
+                    repository: "repository";
+                    slack: "slack";
+                    task_note: "task_note";
+                    web: "web";
+                }>;
+                noteId: z.ZodOptional<z.ZodUUID>;
+                fileId: z.ZodOptional<z.ZodUUID>;
+                documentId: z.ZodOptional<z.ZodUUID>;
+                sessionId: z.ZodOptional<z.ZodUUID>;
+                uri: z.ZodOptional<z.ZodString>;
+                externalId: z.ZodOptional<z.ZodString>;
+                version: z.ZodOptional<z.ZodString>;
+                capturedAt: z.ZodOptional<z.ZodString>;
+                retention: z.ZodOptional<z.ZodEnum<{
+                    full_text: "full_text";
+                    passages: "passages";
+                    reference: "reference";
+                }>>;
+                purpose: z.ZodOptional<z.ZodEnum<{
+                    evidence: "evidence";
+                    reference: "reference";
+                }>>;
+            }, z.core.$strict>>;
+            evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                entryId: z.ZodUUID;
+                revisionId: z.ZodUUID;
+                location: z.ZodDefault<z.ZodObject<{
+                    page: z.ZodOptional<z.ZodNumber>;
+                    passage: z.ZodOptional<z.ZodString>;
+                    messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    path: z.ZodOptional<z.ZodString>;
+                    commit: z.ZodOptional<z.ZodString>;
+                    lineStart: z.ZodOptional<z.ZodNumber>;
+                    lineEnd: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+                quote: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            groupIds: z.ZodDefault<z.ZodArray<z.ZodUUID>>;
+            relationships: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                entryId: z.ZodUUID;
+                relation: z.ZodEnum<{
+                    applies_to: "applies_to";
+                    conflicts_with: "conflicts_with";
+                    depends_on: "depends_on";
+                    related_to: "related_to";
+                    supersedes: "supersedes";
+                }>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+        previousRevisionId: z.ZodNullable<z.ZodUUID>;
+        restoredFromRevisionId: z.ZodNullable<z.ZodUUID>;
+        createdAt: z.ZodString;
+        createdBySessionId: z.ZodNullable<z.ZodUUID>;
+        reviewBatchId: z.ZodNullable<z.ZodUUID>;
+        outcome: z.ZodEnum<{
+            pending: "pending";
+            published: "published";
+            rejected: "rejected";
+            superseded: "superseded";
+        }>;
+    }, z.core.$strict>;
+    archived: z.ZodBoolean;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    indexStatus: z.ZodOptional<z.ZodEnum<{
+        awaiting_funding: "awaiting_funding";
+        indexed: "indexed";
+        indexing: "indexing";
+        provider_failed: "provider_failed";
+        queued: "queued";
+        saved: "saved";
+        source_unavailable: "source_unavailable";
+    }>>;
+}, z.core.$strict>;
+export type KnowledgeEntryRecord = z.infer<typeof KnowledgeEntryRecord>;
+export declare const KnowledgeEntryListRequest: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    mode: z.ZodDefault<z.ZodEnum<{
+        hybrid: "hybrid";
+        keyword: "keyword";
+        vector: "vector";
+    }>>;
+    scope: z.ZodOptional<z.ZodEnum<{
+        organization: "organization";
+        personal: "personal";
+        workspace: "workspace";
+    }>>;
+    groupId: z.ZodOptional<z.ZodUUID>;
+    rootOnly: z.ZodOptional<z.ZodBoolean>;
+    fileId: z.ZodOptional<z.ZodUUID>;
+    includeEvidence: z.ZodOptional<z.ZodBoolean>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        decision: "decision";
+        fact: "fact";
+        group: "group";
+        incident: "incident";
+        note: "note";
+        requirement: "requirement";
+        source: "source";
+    }>>;
+    view: z.ZodDefault<z.ZodEnum<{
+        archived: "archived";
+        needs_review: "needs_review";
+        published: "published";
+        rejected: "rejected";
+    }>>;
+    sessionId: z.ZodOptional<z.ZodUUID>;
+    reviewBatchId: z.ZodOptional<z.ZodUUID>;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type KnowledgeEntryListRequest = z.input<typeof KnowledgeEntryListRequest>;
+/** Lists never transfer whole source texts or evidence quotations. */
+export declare const KnowledgeEntrySummary: z.ZodObject<{
+    id: z.ZodUUID;
+    scope: z.ZodEnum<{
+        organization: "organization";
+        personal: "personal";
+        workspace: "workspace";
+    }>;
+    version: z.ZodNumber;
+    publishedRevisionId: z.ZodNullable<z.ZodUUID>;
+    latestRevisionId: z.ZodUUID;
+    archived: z.ZodBoolean;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    indexStatus: z.ZodOptional<z.ZodEnum<{
+        awaiting_funding: "awaiting_funding";
+        indexed: "indexed";
+        indexing: "indexing";
+        provider_failed: "provider_failed";
+        queued: "queued";
+        saved: "saved";
+        source_unavailable: "source_unavailable";
+    }>>;
+    score: z.ZodOptional<z.ZodNumber>;
+    excerpts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        field: z.ZodEnum<{
+            content: "content";
+            title: "title";
+        }>;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        text: z.ZodString;
+    }, z.core.$strip>>>;
+    revision: z.ZodObject<{
+        id: z.ZodUUID;
+        entryId: z.ZodUUID;
+        number: z.ZodNumber;
+        change: z.ZodEnum<{
+            archive: "archive";
+            upsert: "upsert";
+        }>;
+        previousRevisionId: z.ZodNullable<z.ZodUUID>;
+        restoredFromRevisionId: z.ZodNullable<z.ZodUUID>;
+        createdAt: z.ZodString;
+        createdBySessionId: z.ZodNullable<z.ZodUUID>;
+        reviewBatchId: z.ZodNullable<z.ZodUUID>;
+        outcome: z.ZodEnum<{
+            pending: "pending";
+            published: "published";
+            rejected: "rejected";
+            superseded: "superseded";
+        }>;
+        title: z.ZodString;
+        kind: z.ZodEnum<{
+            decision: "decision";
+            fact: "fact";
+            group: "group";
+            incident: "incident";
+            note: "note";
+            requirement: "requirement";
+            source: "source";
+        }>;
+        preview: z.ZodString;
+        groupIds: z.ZodArray<z.ZodUUID>;
+        sourceKind: z.ZodNullable<z.ZodEnum<{
+            connector: "connector";
+            conversation: "conversation";
+            file: "file";
+            manual: "manual";
+            repository: "repository";
+            slack: "slack";
+            task_note: "task_note";
+            web: "web";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type KnowledgeEntrySummary = z.infer<typeof KnowledgeEntrySummary>;
+export declare const KnowledgeEntryListResponse: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        scope: z.ZodEnum<{
+            organization: "organization";
+            personal: "personal";
+            workspace: "workspace";
+        }>;
+        version: z.ZodNumber;
+        publishedRevisionId: z.ZodNullable<z.ZodUUID>;
+        latestRevisionId: z.ZodUUID;
+        archived: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        indexStatus: z.ZodOptional<z.ZodEnum<{
+            awaiting_funding: "awaiting_funding";
+            indexed: "indexed";
+            indexing: "indexing";
+            provider_failed: "provider_failed";
+            queued: "queued";
+            saved: "saved";
+            source_unavailable: "source_unavailable";
+        }>>;
+        score: z.ZodOptional<z.ZodNumber>;
+        excerpts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            field: z.ZodEnum<{
+                content: "content";
+                title: "title";
+            }>;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            text: z.ZodString;
+        }, z.core.$strip>>>;
+        revision: z.ZodObject<{
+            id: z.ZodUUID;
+            entryId: z.ZodUUID;
+            number: z.ZodNumber;
+            change: z.ZodEnum<{
+                archive: "archive";
+                upsert: "upsert";
+            }>;
+            previousRevisionId: z.ZodNullable<z.ZodUUID>;
+            restoredFromRevisionId: z.ZodNullable<z.ZodUUID>;
+            createdAt: z.ZodString;
+            createdBySessionId: z.ZodNullable<z.ZodUUID>;
+            reviewBatchId: z.ZodNullable<z.ZodUUID>;
+            outcome: z.ZodEnum<{
+                pending: "pending";
+                published: "published";
+                rejected: "rejected";
+                superseded: "superseded";
+            }>;
+            title: z.ZodString;
+            kind: z.ZodEnum<{
+                decision: "decision";
+                fact: "fact";
+                group: "group";
+                incident: "incident";
+                note: "note";
+                requirement: "requirement";
+                source: "source";
+            }>;
+            preview: z.ZodString;
+            groupIds: z.ZodArray<z.ZodUUID>;
+            sourceKind: z.ZodNullable<z.ZodEnum<{
+                connector: "connector";
+                conversation: "conversation";
+                file: "file";
+                manual: "manual";
+                repository: "repository";
+                slack: "slack";
+                task_note: "task_note";
+                web: "web";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+    searchMode: z.ZodOptional<z.ZodEnum<{
+        hybrid: "hybrid";
+        keyword: "keyword";
+        vector: "vector";
+    }>>;
+    fallbackReason: z.ZodOptional<z.ZodEnum<{
+        awaiting_funding: "awaiting_funding";
+        provider_unavailable: "provider_unavailable";
+        query_limit: "query_limit";
+        quota: "quota";
+    }>>;
+}, z.core.$strip>;
+export type KnowledgeEntryListResponse = z.infer<typeof KnowledgeEntryListResponse>;
+export declare const KnowledgeReviewBatch: z.ZodObject<{
+    id: z.ZodUUID;
+    sessionId: z.ZodNullable<z.ZodUUID>;
+    scheduledTaskId: z.ZodNullable<z.ZodUUID>;
+    scheduledTaskRunId: z.ZodNullable<z.ZodUUID>;
+    title: z.ZodNullable<z.ZodString>;
+    scope: z.ZodEnum<{
+        organization: "organization";
+        personal: "personal";
+        workspace: "workspace";
+    }>;
+    pendingCount: z.ZodNumber;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type KnowledgeReviewBatch = z.infer<typeof KnowledgeReviewBatch>;
+export declare const KnowledgeReviewBatchListRequest: z.ZodObject<{
+    scope: z.ZodOptional<z.ZodEnum<{
+        organization: "organization";
+        personal: "personal";
+        workspace: "workspace";
+    }>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type KnowledgeReviewBatchListRequest = z.input<typeof KnowledgeReviewBatchListRequest>;
+export declare const KnowledgeReviewBatchListResponse: z.ZodObject<{
+    batches: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        sessionId: z.ZodNullable<z.ZodUUID>;
+        scheduledTaskId: z.ZodNullable<z.ZodUUID>;
+        scheduledTaskRunId: z.ZodNullable<z.ZodUUID>;
+        title: z.ZodNullable<z.ZodString>;
+        scope: z.ZodEnum<{
+            organization: "organization";
+            personal: "personal";
+            workspace: "workspace";
+        }>;
+        pendingCount: z.ZodNumber;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type KnowledgeReviewBatchListResponse = z.infer<typeof KnowledgeReviewBatchListResponse>;
+/** All policy outcomes are nonblocking; Off refuses authoring, not task execution. */
+export declare function knowledgeWriteDisposition(mode: z.infer<typeof AgentLearningMode>): "disabled" | "pending" | "published";
+export declare const KnowledgeOriginalFileDownload: z.ZodObject<{
+    url: z.ZodString;
+    expiresAt: z.ZodString;
+    fileId: z.ZodUUID;
+    filename: z.ZodString;
+    contentType: z.ZodString;
+    sizeBytes: z.ZodNumber;
+}, z.core.$strict>;
+export type KnowledgeOriginalFileDownload = z.infer<typeof KnowledgeOriginalFileDownload>;