@elizaos/plugin-inbox 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/inbox/email-curation.d.ts

@@ -0,0 +1,174 @@
+export type EmailCurationAction = "save" | "archive" | "delete" | "review";
+export type EmailCurationMode = "body_semantic" | "metadata_degraded";
+export type EmailCurationConfidenceBand = "low" | "medium" | "high";
+export type EmailCurationCitationSource = "subject" | "snippet" | "body" | "headers" | "metadata" | "thread" | "identity" | "policy";
+export type EmailCurationEvidenceEffect = "supports_save" | "supports_archive" | "supports_delete" | "supports_review" | "blocks_delete" | "lowers_confidence";
+export type EmailCurationEvidenceKind = "personal_humor" | "personal_relationship" | "mixed_language_personal" | "direct_human_ask" | "automated_sender" | "bulk_header" | "unsubscribe_signal" | "low_value_marketing" | "low_value_automated" | "spam_folder" | "security_or_billing" | "prompt_injection_attempt" | "thread_conflict" | "vip_sender" | "known_person_sender" | "protected_label" | "duplicate_message";
+export interface EmailCurationBody {
+    text: string;
+    contentType?: "text/plain" | "text/html" | "text/markdown" | "other";
+    source?: "adapter" | "cache" | "provider" | "manual";
+}
+export interface EmailCurationThreadContext {
+    messageCount?: number;
+    participantCount?: number;
+    hasOwnerReplyAfterCandidate?: boolean;
+    hasLaterHumanReply?: boolean;
+    unresolvedHumanReply?: boolean;
+    conflictingSignals?: readonly string[];
+    latestMessageAt?: string | null;
+    summary?: string | null;
+}
+export interface EmailCurationCandidate {
+    id: string;
+    externalId?: string | null;
+    threadId?: string | null;
+    subject?: string | null;
+    snippet?: string | null;
+    from?: string | null;
+    fromEmail?: string | null;
+    replyTo?: string | null;
+    to?: readonly string[] | null;
+    cc?: readonly string[] | null;
+    receivedAt?: string | null;
+    labels?: readonly string[] | null;
+    headers?: Record<string, string | undefined> | null;
+    body?: EmailCurationBody | null;
+    bodyText?: string | null;
+    threadContext?: EmailCurationThreadContext | null;
+    context?: Record<string, unknown> | null;
+}
+export interface EmailCurationPerson {
+    id?: string;
+    name?: string | null;
+    emails: readonly string[];
+    vip?: boolean;
+    labels?: readonly string[];
+    blockDelete?: boolean;
+}
+export type EmailCurationIdentityKind = "vip" | "known_person" | "protected_sender" | "service" | "unknown";
+export interface EmailCurationResolvedIdentity {
+    kind: EmailCurationIdentityKind;
+    label: string;
+    matchedBy: readonly string[];
+    blockDelete: boolean;
+    personId?: string | null;
+}
+export type EmailCurationIdentityHook = (candidate: EmailCurationCandidate) => EmailCurationResolvedIdentity | null;
+export interface EmailCurationIdentityContext {
+    ownerEmail?: string | null;
+    ownerNames?: readonly string[];
+    vipContacts?: readonly EmailCurationPerson[];
+    knownPeople?: readonly EmailCurationPerson[];
+    protectedSenders?: readonly string[];
+    personalDomains?: readonly string[];
+}
+export interface EmailCurationPolicyEffect {
+    kind: "block_action" | "force_review" | "lower_confidence" | "add_reason";
+    action?: EmailCurationAction;
+    amount?: number;
+    code: string;
+    message: string;
+    citation?: EmailCurationCitation;
+}
+export interface EmailCurationPolicyHookContext {
+    candidate: EmailCurationCandidate;
+    identity: EmailCurationResolvedIdentity;
+    provisionalAction: EmailCurationAction;
+    provisionalConfidence: number;
+    evidence: readonly EmailCurationEvidence[];
+}
+export type EmailCurationPolicyHook = (context: EmailCurationPolicyHookContext) => readonly EmailCurationPolicyEffect[];
+export interface EmailCurationPolicy {
+    allowDelete?: boolean;
+    allowBulkDelete?: boolean;
+    blockDeleteForKnownPeople?: boolean;
+    blockDeleteForVip?: boolean;
+    deleteConfidenceThreshold?: number;
+    archiveConfidenceThreshold?: number;
+    saveConfidenceThreshold?: number;
+    protectedLabels?: readonly string[];
+}
+export interface EmailCurationInput {
+    candidates: readonly EmailCurationCandidate[];
+    identityContext?: EmailCurationIdentityContext;
+    identityHook?: EmailCurationIdentityHook;
+    policy?: EmailCurationPolicy;
+    policyHook?: EmailCurationPolicyHook;
+    now?: string;
+}
+export interface EmailCurationSpan {
+    source: EmailCurationCitationSource;
+    field?: string;
+    start: number;
+    end: number;
+    quote: string;
+}
+export interface EmailCurationCitation {
+    id: string;
+    candidateId: string;
+    span: EmailCurationSpan;
+}
+export interface EmailCurationEvidence {
+    kind: EmailCurationEvidenceKind;
+    effect: EmailCurationEvidenceEffect;
+    strength: number;
+    label: string;
+    detail: string;
+    citations: readonly EmailCurationCitation[];
+    semantic: boolean;
+}
+export interface CurationReason {
+    code: EmailCurationEvidenceKind | "metadata_only" | "policy";
+    label: string;
+    reviewText: string;
+    citations: readonly EmailCurationCitation[];
+}
+export interface CurationBulkReview {
+    destructive: boolean;
+    summary: string;
+    rationale: string;
+    safeguards: readonly string[];
+}
+export interface CurationDecision {
+    candidateId: string;
+    canonicalMessageIds: readonly string[];
+    duplicateMessageIds: readonly string[];
+    threadId: string | null;
+    action: EmailCurationAction;
+    rank: number;
+    confidence: number;
+    confidenceBand: EmailCurationConfidenceBand;
+    mode: EmailCurationMode;
+    degraded: boolean;
+    degradationReason: string | null;
+    identity: EmailCurationResolvedIdentity;
+    reasons: readonly CurationReason[];
+    evidence: readonly EmailCurationEvidence[];
+    citations: readonly EmailCurationCitation[];
+    policyEffects: readonly EmailCurationPolicyEffect[];
+    blockedActions: readonly EmailCurationAction[];
+    bulkReview: CurationBulkReview;
+}
+export interface EmailCurationOutput {
+    decisions: readonly CurationDecision[];
+    generatedAt: string;
+    degradedCount: number;
+    collapsedDuplicateCount: number;
+    promptInjectionCandidateIds: readonly string[];
+}
+export interface EmailCurationConfidenceCalibrationInput {
+    action: EmailCurationAction;
+    scores: Readonly<Record<EmailCurationAction, number>>;
+    evidence: readonly EmailCurationEvidence[];
+    degraded: boolean;
+    blockedDelete: boolean;
+    threadConflict: boolean;
+    policyEffects: readonly EmailCurationPolicyEffect[];
+}
+export declare function wrapUntrustedEmailCurationContent(content: string): string;
+export declare function calibrateEmailCurationConfidence(input: EmailCurationConfidenceCalibrationInput): number;
+export declare function curateEmailCandidates(input: EmailCurationInput): EmailCurationOutput;
+export declare function validateCurationDecisionCitations(decision: CurationDecision): string[];
+export declare function buildEmailCurationPrompt(input: EmailCurationInput | EmailCurationCandidate): string;
+//# sourceMappingURL=email-curation.d.ts.map

package/dist/inbox/email-curation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-curation.d.ts","sourceRoot":"","sources":["../../src/inbox/email-curation.ts"],"names":[],"mappings":"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"}