@opengeni/db 1.0.1 → 3.2.0-canary.0

package/dist/company-brain-context-selection.d.ts

@@ -0,0 +1,94 @@
+import type { KnowledgeMemoryKind, HistoricalMemoryPromptMode } from "@opengeni/contracts";
+import type { Database } from "./database.js";
+export type CompanyBrainContextAttemptClaims = Readonly<{
+    accountId: string;
+    workspaceId: string;
+    sessionId: string;
+    turnId: string;
+    attemptId: string;
+    executionGeneration: number;
+}>;
+export type CompanyBrainMemorySelectionReference = Readonly<{
+    id: string;
+    kind: KnowledgeMemoryKind;
+    textHash: string;
+    contentHash: string;
+    textCodecVersion: number | null;
+    memoryVersion: number;
+    pinned: boolean;
+}>;
+export type CompanyBrainContextSelectionReceipt = Readonly<{
+    id: string;
+    rootSessionId: string;
+    acceptedAt: string;
+    sessionRole: "root" | "child";
+    memoryEnabled: boolean;
+    memoryPromptMode: HistoricalMemoryPromptMode;
+    companyProfileIncluded: boolean;
+    instructionPolicyEntryHash: string;
+    preferenceDescriptorHash: string | null;
+    companyProfileSnapshotHash: string;
+    turnContextSnapshotId: string;
+    turnContextSnapshotHash: string;
+    turnContextSnapshotSource: "accepted_turn" | "legacy_first_claim";
+    legacyWorkspaceInstructionsOriginalUtf8Bytes: number | null;
+    legacyWorkspaceInstructionsTruncated: boolean;
+    selectionHash: string;
+    selectedMemoryCount: number;
+    renderedMemoryCount: number;
+    visibleMemoryCount: number;
+    budgetOmittedMemoryCount: number;
+    authorizationOmittedMemoryCount: number;
+    omittedMemoryCount: number;
+}>;
+export type ResolvedCompanyBrainContextSelection = Readonly<{
+    receipt: CompanyBrainContextSelectionReceipt;
+    legacyWorkspaceInstructions: string | null;
+    workspaceMemory: string | null;
+}>;
+export type CompanyBrainContextReceiptInspection = Readonly<{
+    id: string;
+    sessionId: string;
+    rootSessionId: string;
+    turnId: string;
+    acceptedAt: string;
+    createdAt: string;
+    sessionRole: "root" | "child";
+    memoryEnabled: boolean;
+    memoryPromptMode: HistoricalMemoryPromptMode;
+    companyProfileIncluded: boolean;
+    instructionPolicyEntryHash: string;
+    preferenceDescriptorHash: string | null;
+    companyProfileSnapshotHash: string;
+    turnContextSnapshotId: string;
+    turnContextSnapshotHash: string;
+    turnContextSnapshotSource: "accepted_turn" | "legacy_first_claim";
+    selectionHash: string;
+    selectedMemoryCount: number;
+    renderedMemoryCount: number;
+    budgetOmittedMemoryCount: number;
+}>;
+export type CompanyBrainContextReceiptInspectionCursor = Readonly<{
+    createdAt: string;
+    id: string;
+}>;
+export type InspectCompanyBrainContextReceiptsInput = Readonly<{
+    workspaceId: string;
+    subjectId: string;
+    attemptId?: string;
+    before?: CompanyBrainContextReceiptInspectionCursor;
+    limit?: number;
+}>;
+/**
+ * Read a bounded, content-free projection of existing accepted-turn receipts.
+ * The SQL capability independently proves the exact human and both session
+ * references; this adapter never calls the receipt-creating worker function.
+ */
+export declare function inspectCompanyBrainContextReceipts(db: Database, input: InspectCompanyBrainContextReceiptsInput): Promise<readonly CompanyBrainContextReceiptInspection[]>;
+/**
+ * Freeze the broad legacy workspace-Memory candidate set once per accepted
+ * logical turn. Recovery gets the original candidate identities and may only
+ * lose rows that no longer pass current lifecycle/hash authorization. The
+ * durable receipt contains references and hashes, never memory text.
+ */
+export declare function resolveCompanyBrainContextSelection(db: Database, claims: CompanyBrainContextAttemptClaims): Promise<ResolvedCompanyBrainContextSelection>;

package/dist/company-brain-governed-writes.d.ts

@@ -0,0 +1,24 @@
+import { CompanyBrainGovernedWriteAttempt, type CompanyBrainGovernedWriteReceipt as CompanyBrainGovernedWriteReceiptType, type CompanyBrainGovernedWriteRequest as CompanyBrainGovernedWriteRequestType } from "@opengeni/contracts";
+import type { Database } from "./database.js";
+export declare class CompanyBrainGovernedWriteAuthorityError extends Error {
+    readonly name = "CompanyBrainGovernedWriteAuthorityError";
+}
+export declare class CompanyBrainGovernedWriteInvalidOperationError extends Error {
+    readonly name = "CompanyBrainGovernedWriteInvalidOperationError";
+}
+/**
+ * Route one explicit workspace-local proposal. This owns write admission only;
+ * selector snapshots, logical-turn receipts, tools, and activation remain out of scope.
+ */
+/**
+ * Write result: the agent-facing receipt plus the exact initiating human the
+ * accepted attempt froze. The subject id is internal routing authority for the
+ * governed-learning evaluator/controller and is stripped from public receipts.
+ */
+export type CompanyBrainGovernedWriteResult = CompanyBrainGovernedWriteReceiptType & {
+    initiatingHumanSubjectId: string;
+};
+export declare function writeCompanyBrainGovernedProposal(db: Database, rawInput: {
+    attempt: CompanyBrainGovernedWriteAttempt;
+    request: CompanyBrainGovernedWriteRequestType;
+}): Promise<CompanyBrainGovernedWriteResult>;

package/dist/company-brain.d.ts

@@ -0,0 +1,55 @@
+import { type CompanyBrainKnowledgeProposalPage } from "@opengeni/contracts";
+import type { Database } from "./database.js";
+export declare const COMPANY_BRAIN_PREFERENCE_MAX_COUNT = 100;
+export declare const COMPANY_BRAIN_PREFERENCE_MAX_REVISIONS = 256;
+export declare const COMPANY_BRAIN_PREFERENCE_MAX_CONTENT_BYTES: number;
+export type CompanyBrainPreferenceGuidanceRow = {
+    preferenceId: string;
+    stableKey: string;
+    scope: string;
+    status: string;
+    supersededByPreferenceId: string | null;
+    revisionId: string;
+    revision: number;
+    title: string;
+    description: string;
+    content: string;
+    contentHash: string;
+    provenanceSource: string;
+    provenanceSourceId: string | null;
+    trust: string;
+    correctsRevisionId: string | null;
+    expiresAt: Date | null;
+    createdAt: Date;
+    active: boolean;
+};
+export type CompanyBrainPreferenceGuidancePage = {
+    rows: CompanyBrainPreferenceGuidanceRow[];
+    preferenceCountTruncated: boolean;
+    revisionCountTruncated: boolean;
+    contentBytesTruncated: boolean;
+};
+/**
+ * Read-only review projection over governed Knowledge change proposals. RLS
+ * filters scope before rows enter this independent item/aggregate byte bound.
+ */
+export declare function listCompanyBrainKnowledgeProposals(db: Database, input: {
+    workspaceId: string;
+    subjectId: string;
+    limit?: number;
+}): Promise<CompanyBrainKnowledgeProposalPage>;
+export declare function listActivatedCompanyBrainPolicyRevisionIds(db: Database, input: {
+    workspaceId: string;
+    subjectId: string;
+    revisionIds: string[];
+}): Promise<string[]>;
+/**
+ * Read bounded full guidance only after applying the existing subject-aware
+ * Preference Registry RLS context. Personal rows for another subject never
+ * enter the candidate set, and relationship targets are filtered by the API
+ * projection against this authorized page.
+ */
+export declare function listCompanyBrainPreferenceGuidance(db: Database, input: {
+    workspaceId: string;
+    subjectId: string;
+}): Promise<CompanyBrainPreferenceGuidancePage>;

package/dist/company-profile-agent-admin.d.ts

@@ -0,0 +1,15 @@
+import { type CompanyProfileAgentAttempt as CompanyProfileAgentAttemptType, type CompanyProfileAgentConfirmRequest as CompanyProfileAgentConfirmRequestType, type CompanyProfileAgentConfirmationReceipt as CompanyProfileAgentConfirmationReceiptType, type CompanyProfileAgentProposalReceipt as CompanyProfileAgentProposalReceiptType, type CompanyProfileAgentProposalRequest as CompanyProfileAgentProposalRequestType } from "@opengeni/contracts";
+import { type Database } from "./database.js";
+export declare class CompanyProfileAgentAdminError extends Error {
+    readonly code: "authority_unavailable" | "confirmation_unavailable" | "profile_conflict" | "operation_reused" | "invalid_operation";
+    readonly name = "CompanyProfileAgentAdminError";
+    constructor(code: "authority_unavailable" | "confirmation_unavailable" | "profile_conflict" | "operation_reused" | "invalid_operation", message: string, options?: ErrorOptions);
+}
+export declare function proposeCompanyProfileForAgent(db: Database, raw: {
+    attempt: CompanyProfileAgentAttemptType;
+    request: CompanyProfileAgentProposalRequestType;
+}): Promise<CompanyProfileAgentProposalReceiptType>;
+export declare function confirmCompanyProfileForAgent(db: Database, raw: {
+    attempt: CompanyProfileAgentAttemptType;
+    request: CompanyProfileAgentConfirmRequestType;
+}): Promise<CompanyProfileAgentConfirmationReceiptType>;