@opengeni/contracts 0.50.0 → 2.2.0-canary.0

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

@@ -0,0 +1,154 @@
+import { z } from "zod";
+export declare const GovernedLearningActivationDestination: z.ZodEnum<{
+    instruction_policy: "instruction_policy";
+    preference: "preference";
+}>;
+export declare const GovernedLearningActivationAuthorityKind: z.ZodEnum<{
+    automatic: "automatic";
+    human_confirmed: "human_confirmed";
+}>;
+export type GovernedLearningActivationAuthorityKind = z.infer<typeof GovernedLearningActivationAuthorityKind>;
+export type GovernedLearningActivationDestination = z.infer<typeof GovernedLearningActivationDestination>;
+export declare const GovernedLearningActivationCaller: z.ZodObject<{
+    workspaceId: z.ZodString;
+    subjectId: z.ZodString;
+}, z.core.$strict>;
+export type GovernedLearningActivationCaller = z.infer<typeof GovernedLearningActivationCaller>;
+export declare const ActivateGovernedLearningDecisionRequest: z.ZodObject<{
+    operationId: z.ZodString;
+    decisionReceiptId: z.ZodString;
+}, z.core.$strict>;
+export type ActivateGovernedLearningDecisionRequest = z.infer<typeof ActivateGovernedLearningDecisionRequest>;
+export declare const UndoGovernedLearningActivationRequest: z.ZodObject<{
+    operationId: z.ZodString;
+    activationReceiptId: z.ZodString;
+}, z.core.$strict>;
+export type UndoGovernedLearningActivationRequest = z.infer<typeof UndoGovernedLearningActivationRequest>;
+/**
+ * Immutable content-free proof that one final automatic evaluator receipt was
+ * revalidated and applied through the destination-owned lifecycle.
+ */
+export declare const GovernedLearningActivationReceipt: z.ZodObject<{
+    destination: z.ZodEnum<{
+        instruction_policy: "instruction_policy";
+        preference: "preference";
+    }>;
+    destinationProposalId: z.ZodString;
+    destinationRevisionId: z.ZodString;
+    destinationOldRevisionId: z.ZodNullable<z.ZodString>;
+    destinationOldContentHash: z.ZodNullable<z.ZodString>;
+    destinationOldVersion: z.ZodNumber;
+    destinationNewContentHash: z.ZodString;
+    destinationNewVersion: z.ZodNumber;
+    destinationEventId: z.ZodString;
+    id: z.ZodString;
+    operationId: z.ZodString;
+    inputHash: z.ZodString;
+    accountId: z.ZodString;
+    workspaceId: z.ZodString;
+    decisionReceiptId: z.ZodString;
+    initiatingHumanSubjectId: z.ZodString;
+    serviceActorSubjectId: z.ZodString;
+    policyRevisionId: z.ZodString;
+    policyHash: z.ZodString;
+    policyActivationVersion: z.ZodNumber;
+    sourceKind: z.ZodEnum<{
+        "scoped-knowledge-evidence": "scoped-knowledge-evidence";
+        "task-note": "task-note";
+    }>;
+    sourceId: z.ZodString;
+    sourceAuthorityHash: z.ZodString;
+    proposalId: z.ZodString;
+    claimId: z.ZodString;
+    evidenceId: z.ZodString;
+    knowledgePreviousReviewId: z.ZodString;
+    knowledgePreviousReviewRevision: z.ZodNumber;
+    knowledgeApprovalReviewId: z.ZodString;
+    knowledgeApprovalReviewRevision: z.ZodNumber;
+    knowledgeApprovalInputHash: z.ZodString;
+    outcome: z.ZodLiteral<"activated">;
+    effectiveAt: z.ZodString;
+    authorityKind: z.ZodEnum<{
+        automatic: "automatic";
+        human_confirmed: "human_confirmed";
+    }>;
+    humanInputRequestId: z.ZodNullable<z.ZodString>;
+    rollback: z.ZodObject<{
+        supported: z.ZodLiteral<true>;
+        mechanism: z.ZodLiteral<"exact_head_and_latest_review">;
+    }, z.core.$strict>;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export type GovernedLearningActivationReceipt = z.infer<typeof GovernedLearningActivationReceipt>;
+export declare const ActivateHumanConfirmedLearningDecisionRequest: z.ZodObject<{
+    operationId: z.ZodString;
+    decisionReceiptId: z.ZodString;
+    humanInputRequestId: z.ZodString;
+}, z.core.$strict>;
+export type ActivateHumanConfirmedLearningDecisionRequest = z.infer<typeof ActivateHumanConfirmedLearningDecisionRequest>;
+/** Append-only compensation proof. Undo never deletes prior evidence. */
+export declare const GovernedLearningActivationUndoReceipt: z.ZodObject<{
+    id: z.ZodString;
+    operationId: z.ZodString;
+    inputHash: z.ZodString;
+    accountId: z.ZodString;
+    workspaceId: z.ZodString;
+    activationReceiptId: z.ZodString;
+    initiatingHumanSubjectId: z.ZodString;
+    serviceActorSubjectId: z.ZodString;
+    destination: z.ZodEnum<{
+        instruction_policy: "instruction_policy";
+        preference: "preference";
+    }>;
+    knowledgeApprovalReviewId: z.ZodString;
+    knowledgeRevocationReviewId: z.ZodString;
+    knowledgeRevocationReviewRevision: z.ZodNumber;
+    knowledgeRevocationInputHash: z.ZodString;
+    destinationActivatedRevisionId: z.ZodString;
+    destinationRestoredRevisionId: z.ZodNullable<z.ZodString>;
+    destinationActivatedContentHash: z.ZodString;
+    destinationRestoredContentHash: z.ZodNullable<z.ZodString>;
+    destinationOldVersion: z.ZodNumber;
+    destinationNewVersion: z.ZodNumber;
+    destinationEventId: z.ZodString;
+    outcome: z.ZodLiteral<"undone">;
+    superseded: z.ZodLiteral<false>;
+    effectiveAt: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export type GovernedLearningActivationUndoReceipt = z.infer<typeof GovernedLearningActivationUndoReceipt>;
+/**
+ * Immutable content-free proof that the exact initiating human confirmed a
+ * user-directed Knowledge claim (`remember` with lane `knowledge`) through the
+ * bound structured human-input question, after which the claim's latest
+ * `proposed` review was superseded by an `approved` service review.
+ */
+export declare const RememberKnowledgeConfirmationReceipt: z.ZodObject<{
+    id: z.ZodString;
+    operationId: z.ZodString;
+    inputHash: z.ZodString;
+    accountId: z.ZodString;
+    workspaceId: z.ZodString;
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+    executionGeneration: z.ZodNumber;
+    initiatingHumanSubjectId: z.ZodString;
+    serviceActorSubjectId: z.ZodString;
+    claimId: z.ZodString;
+    evidenceId: z.ZodString;
+    taskNoteId: z.ZodString;
+    taskNoteTextHash: z.ZodString;
+    humanInputRequestId: z.ZodString;
+    previousReviewId: z.ZodString;
+    previousReviewRevision: z.ZodNumber;
+    approvalReviewId: z.ZodString;
+    approvalReviewRevision: z.ZodNumber;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export type RememberKnowledgeConfirmationReceipt = z.infer<typeof RememberKnowledgeConfirmationReceipt>;
+export declare const ConfirmRememberKnowledgeClaimRequest: z.ZodObject<{
+    operationId: z.ZodString;
+    claimId: z.ZodString;
+    humanInputRequestId: z.ZodString;
+}, z.core.$strict>;
+export type ConfirmRememberKnowledgeClaimRequest = z.infer<typeof ConfirmRememberKnowledgeClaimRequest>;

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

@@ -0,0 +1,152 @@
+import { z } from "zod";
+/**
+ * Automatic is intentionally conservative in the first evaluator tranche.
+ * This constant is platform-owned rather than caller-selectable so an agent or
+ * connector cannot lower the admission floor inside one request.
+ */
+export declare const GOVERNED_LEARNING_AUTOMATIC_CONFIDENCE_FLOOR_BPS = 8500;
+export declare const GOVERNED_LEARNING_MAX_CONFLICT_COUNT = 1000;
+export declare const GovernedLearningDecisionOutcome: z.ZodEnum<{
+    automatic: "automatic";
+    confidence: "confidence";
+    conflict: "conflict";
+    off: "off";
+    revoked: "revoked";
+    stale: "stale";
+    suggest: "suggest";
+}>;
+export type GovernedLearningDecisionOutcome = z.infer<typeof GovernedLearningDecisionOutcome>;
+/** Stable order used by TypeScript, SQL constraints, and public receipts. */
+export declare const GOVERNED_LEARNING_REASON_ORDER: readonly ["policy_off", "evidence_revoked", "proposal_stale", "evidence_conflict", "confidence_below_floor", "policy_suggest", "policy_automatic"];
+export declare const GovernedLearningDecisionReason: z.ZodEnum<{
+    confidence_below_floor: "confidence_below_floor";
+    evidence_conflict: "evidence_conflict";
+    evidence_revoked: "evidence_revoked";
+    policy_automatic: "policy_automatic";
+    policy_off: "policy_off";
+    policy_suggest: "policy_suggest";
+    proposal_stale: "proposal_stale";
+}>;
+export type GovernedLearningDecisionReason = z.infer<typeof GovernedLearningDecisionReason>;
+export declare const GovernedLearningDecisionFacts: z.ZodObject<{
+    effectiveMode: z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        suggest: "suggest";
+    }>;
+    confidenceBps: z.ZodNumber;
+    conflictCount: z.ZodNumber;
+    stale: z.ZodBoolean;
+    revoked: z.ZodBoolean;
+}, z.core.$strict>;
+export type GovernedLearningDecisionFacts = z.infer<typeof GovernedLearningDecisionFacts>;
+export declare const GovernedLearningDecision: z.ZodObject<{
+    outcome: z.ZodEnum<{
+        automatic: "automatic";
+        confidence: "confidence";
+        conflict: "conflict";
+        off: "off";
+        revoked: "revoked";
+        stale: "stale";
+        suggest: "suggest";
+    }>;
+    reasons: z.ZodArray<z.ZodEnum<{
+        confidence_below_floor: "confidence_below_floor";
+        evidence_conflict: "evidence_conflict";
+        evidence_revoked: "evidence_revoked";
+        policy_automatic: "policy_automatic";
+        policy_off: "policy_off";
+        policy_suggest: "policy_suggest";
+        proposal_stale: "proposal_stale";
+    }>>;
+    automaticEligible: z.ZodBoolean;
+    confidenceFloorBps: z.ZodLiteral<8500>;
+}, z.core.$strict>;
+export type GovernedLearningDecision = z.infer<typeof GovernedLearningDecision>;
+export declare const GovernedLearningEvaluationAttempt: z.ZodObject<{
+    workspaceId: z.ZodString;
+    subjectId: z.ZodString;
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+    attemptId: z.ZodString;
+    executionGeneration: z.ZodNumber;
+}, z.core.$strict>;
+export type GovernedLearningEvaluationAttempt = z.infer<typeof GovernedLearningEvaluationAttempt>;
+export declare const EvaluateGovernedLearningProposalRequest: z.ZodObject<{
+    operationId: z.ZodString;
+    policySnapshotId: z.ZodString;
+    proposalId: z.ZodString;
+    claimId: z.ZodString;
+    evidenceId: z.ZodString;
+}, z.core.$strict>;
+export type EvaluateGovernedLearningProposalRequest = z.infer<typeof EvaluateGovernedLearningProposalRequest>;
+/**
+ * Content-free immutable evidence. Hashes and bounded enums identify exactly
+ * what was evaluated without copying proposal, fact, citation, or note text.
+ */
+export declare const GovernedLearningDecisionReceipt: z.ZodObject<{
+    id: z.ZodString;
+    operationId: z.ZodString;
+    inputHash: z.ZodString;
+    accountId: z.ZodString;
+    workspaceId: z.ZodString;
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+    attemptId: z.ZodString;
+    executionGeneration: z.ZodNumber;
+    initiatingHumanSubjectId: z.ZodString;
+    policySnapshotId: z.ZodString;
+    policySnapshotHash: z.ZodString;
+    policyRevisionId: z.ZodNullable<z.ZodString>;
+    policyActivationVersion: z.ZodNumber;
+    sourceKind: z.ZodEnum<{
+        "scoped-knowledge-evidence": "scoped-knowledge-evidence";
+        "task-note": "task-note";
+    }>;
+    sourceId: z.ZodString;
+    proposalId: z.ZodString;
+    proposalInputHash: z.ZodString;
+    proposalContentHash: z.ZodString;
+    claimId: z.ZodString;
+    claimInputHash: z.ZodString;
+    evidenceId: z.ZodString;
+    evidenceInputHash: z.ZodString;
+    evidenceContentHash: z.ZodString;
+    evidenceAuthorityHash: z.ZodString;
+    reviewRevision: z.ZodNumber;
+    reviewState: z.ZodEnum<{
+        approved: "approved";
+        proposed: "proposed";
+        rejected: "rejected";
+        revoked: "revoked";
+    }>;
+    effectiveMode: z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        suggest: "suggest";
+    }>;
+    confidenceBps: z.ZodNumber;
+    conflictCount: z.ZodNumber;
+    outcome: z.ZodEnum<{
+        automatic: "automatic";
+        confidence: "confidence";
+        conflict: "conflict";
+        off: "off";
+        revoked: "revoked";
+        stale: "stale";
+        suggest: "suggest";
+    }>;
+    reasons: z.ZodArray<z.ZodEnum<{
+        confidence_below_floor: "confidence_below_floor";
+        evidence_conflict: "evidence_conflict";
+        evidence_revoked: "evidence_revoked";
+        policy_automatic: "policy_automatic";
+        policy_off: "policy_off";
+        policy_suggest: "policy_suggest";
+        proposal_stale: "proposal_stale";
+    }>>;
+    automaticEligible: z.ZodBoolean;
+    confidenceFloorBps: z.ZodLiteral<8500>;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export type GovernedLearningDecisionReceipt = z.infer<typeof GovernedLearningDecisionReceipt>;