@opengeni/db 0.36.1 → 3.1.0-canary.0

package/dist/governed-learning-activation.d.ts

@@ -0,0 +1,98 @@
+import { type ActivateGovernedLearningDecisionRequest as ActivateRequest, type ActivateHumanConfirmedLearningDecisionRequest as ActivateHumanConfirmedRequest, type ConfirmRememberKnowledgeClaimRequest as ConfirmRememberKnowledgeClaimRequestType, type RememberKnowledgeConfirmationReceipt as RememberKnowledgeConfirmationReceiptType, type GovernedLearningActivationCaller as ActivationCaller, type GovernedLearningActivationReceipt as ActivationReceipt, type GovernedLearningActivationUndoReceipt as UndoReceipt, type UndoGovernedLearningActivationRequest as UndoRequest } from "@opengeni/contracts";
+import type { Database } from "./database.js";
+export declare class GovernedLearningActivationAuthorityError extends Error {
+    readonly name = "GovernedLearningActivationAuthorityError";
+}
+export declare class GovernedLearningActivationConflictError extends Error {
+    readonly name = "GovernedLearningActivationConflictError";
+}
+export declare class GovernedLearningActivationInvalidOperationError extends Error {
+    readonly name = "GovernedLearningActivationInvalidOperationError";
+}
+/** Subject-filtered activation and compensation history for Workspace State. */
+export declare function listGovernedLearningActivationHistory(db: Database, input: {
+    workspaceId: string;
+    subjectId: string;
+    principalKind: string;
+    limit: number;
+}): Promise<{
+    activations: ActivationReceipt[];
+    undos: UndoReceipt[];
+    truncated: boolean;
+}>;
+export declare function activateGovernedLearningDecision(db: Database, raw: {
+    caller: ActivationCaller;
+    request: ActivateRequest;
+}): Promise<ActivationReceipt>;
+/**
+ * Activate one confirmable evaluator receipt (`suggest`, `automatic`, or
+ * `confidence`) because the exact initiating human answered the bound
+ * `remember:<proposalId>` structured human-input question with `save` on the
+ * same session/turn generation. The database capability revalidates the human
+ * answer, current policy (not `off`), evidence, and destination CAS.
+ */
+export declare function activateHumanConfirmedLearningDecision(db: Database, raw: {
+    caller: ActivationCaller;
+    request: ActivateHumanConfirmedRequest;
+}): Promise<ActivationReceipt>;
+export declare function undoGovernedLearningActivation(db: Database, raw: {
+    caller: ActivationCaller;
+    request: UndoRequest;
+}): Promise<UndoReceipt>;
+export type GovernedLearningEvidenceOrigin = {
+    kind: "task-note";
+} | {
+    kind: "document";
+    providerKey: string | null;
+};
+/**
+ * Resolve where the evidence behind a governed-learning receipt came from, so
+ * notification sinks can fail closed for evidence that originated in the same
+ * connector they publish to (loop prevention). Returns `null` when the exact
+ * evidence row is not visible under the workspace authority.
+ */
+export declare function resolveGovernedLearningEvidenceOrigin(db: Database, input: {
+    workspaceId: string;
+    evidenceId: string;
+}): Promise<GovernedLearningEvidenceOrigin | null>;
+export type GovernedLearningProposalSummary = {
+    id: string;
+    claimId: string;
+    evidenceId: string;
+    status: string;
+    targetKind: string;
+    initiatingHumanSubjectId: string | null;
+};
+/**
+ * Read one workspace-scoped `knowledge_change_proposals` row under workspace
+ * RLS. Used by `remember_confirm` to rebuild the evaluator request for the
+ * exact proposal the human confirmed; it exposes no content.
+ */
+export declare function getWorkspaceKnowledgeChangeProposalSummary(db: Database, input: {
+    workspaceId: string;
+    proposalId: string;
+}): Promise<GovernedLearningProposalSummary | null>;
+/**
+ * Approve one user-directed Knowledge claim after the exact initiating human
+ * answered the bound `remember:<claimId>` structured human-input question with
+ * `save` on the live turn. The database capability revalidates the claim,
+ * Task-note evidence, latest `proposed` review, and the canonical question
+ * before writing the approval through the guarded service-review path.
+ */
+export declare function confirmRememberKnowledgeClaim(db: Database, raw: {
+    caller: ActivationCaller & {
+        sessionId: string;
+        turnId: string;
+        executionGeneration: number;
+    };
+    request: ConfirmRememberKnowledgeClaimRequestType;
+}): Promise<RememberKnowledgeConfirmationReceiptType>;
+/**
+ * Read the initiating human bound to one workspace-scoped Knowledge claim under
+ * workspace RLS. Used by `remember_confirm` for the Knowledge lane; exposes no
+ * content.
+ */
+export declare function getWorkspaceKnowledgeClaimInitiatingHuman(db: Database, input: {
+    workspaceId: string;
+    claimId: string;
+}): Promise<string | null>;