@unson/brainbase-mcp 0.1.0 → 0.2.2

package/dist/connected-onboarding.d.ts

@@ -0,0 +1,123 @@
+declare const WORKFLOW_STATES: readonly ["initialized", "source_ready", "candidates_ready", "promotion_reviewed", "first_value_ready", "first_value_answer_reviewed"];
+export type SourceMode = 'mcp' | 'drive' | 'gmail' | 'local_folder' | 'single_document';
+export type SourceStatus = 'ready' | 'waiting_for_authorization' | 'unavailable' | 'error' | 'unconfirmed';
+export type ObservationClass = 'observed' | 'inferred';
+export type ReviewDecision = 'approve' | 'edit' | 'reject' | 'merge';
+export type WorkflowState = typeof WORKFLOW_STATES[number];
+export interface SourceInventoryInput {
+    id: string;
+    mode: SourceMode;
+    status: SourceStatus;
+    evidencePointer?: string;
+    permissionScope?: string[];
+    detail?: string;
+}
+export interface SourceInventory extends SourceInventoryInput {
+    id: string;
+    permissionScope: string[];
+}
+export interface SourceReceiptInput {
+    sourceId: string;
+    evidencePointer: string;
+    contentHash: string;
+    permissionSnapshot: Record<string, unknown>;
+    collectionStatus: 'collected';
+}
+export interface CandidateInput {
+    kind: string;
+    payload: Record<string, unknown>;
+    observationClass: ObservationClass;
+    evidenceId: string;
+}
+export interface ConnectedCandidate extends CandidateInput {
+    id: string;
+    ingestedPayloadHash: string;
+    sourceId: string;
+    reviewStatus: 'pending' | 'approved' | 'rejected' | 'merged';
+    reviewDecision?: ReviewDecision;
+    reviewReason?: string;
+    mergedIntoCandidateId?: string;
+    promotedCanonicalIds: string[];
+}
+export interface SourceReceipt extends SourceReceiptInput {
+    mode: SourceMode;
+    collectedAt: string;
+    candidateIds: string[];
+}
+export interface FirstValueReceipt {
+    answerHash: string;
+    usedCanonicalIds: string[];
+    missingContext: string[];
+    recordedAt: string;
+}
+export interface FirstValueReview {
+    verdict: 'useful' | 'not_useful';
+    missingContext: string[];
+    reviewedAt: string;
+    elapsedSeconds: number;
+    withinTargetSeconds: boolean;
+}
+export interface ConnectedOnboardingRun {
+    id: string;
+    valueTarget: string;
+    path: 'warm' | 'fallback' | 'blocked';
+    state: WorkflowState;
+    startedAt: string;
+    updatedAt: string;
+    sourceReadyAt?: string;
+    sources: SourceInventory[];
+    selectedSourceIds: string[];
+    receipts: SourceReceipt[];
+    candidates: ConnectedCandidate[];
+    promotedCanonicalIds: string[];
+    firstValueReceipt?: FirstValueReceipt;
+    firstValueReview?: FirstValueReview;
+}
+export interface ConnectedOnboardingOptions {
+    now?: () => Date;
+    idFactory?: () => string;
+}
+export interface ReviewAction {
+    candidateId: string;
+    decision: ReviewDecision;
+    reason: string;
+    payload?: Record<string, unknown>;
+    mergeIntoCandidateId?: string;
+}
+export type FirstValueInput = {
+    action: 'record';
+    answerHash: string;
+    usedCanonicalIds: string[];
+    missingContext?: string[];
+} | {
+    action: 'review';
+    verdict: 'useful' | 'not_useful';
+    missingContext?: string[];
+};
+export declare class ConnectedOnboardingError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class ConnectedOnboardingRuntime {
+    private readonly dataDir;
+    private readonly now;
+    private readonly idFactory;
+    constructor(dataDir: string, options?: ConnectedOnboardingOptions);
+    start(input: {
+        valueTarget: string;
+        sources: SourceInventoryInput[];
+    }): Promise<ConnectedOnboardingRun>;
+    get(runId: string): Promise<ConnectedOnboardingRun>;
+    ingest(runId: string, input: {
+        source: SourceReceiptInput;
+        candidates: CandidateInput[];
+    }): Promise<ConnectedOnboardingRun>;
+    review(runId: string, actions: ReviewAction[]): Promise<ConnectedOnboardingRun>;
+    firstValue(runId: string, input: FirstValueInput): Promise<ConnectedOnboardingRun>;
+    private timestamp;
+    private readLedger;
+    private mutateLedger;
+}
+export declare function normalizeSourceInventory(raw: SourceInventoryInput[]): SourceInventory[];
+export declare function assertSafePersistentValue(value: unknown, trail?: string[]): void;
+export {};