deepadata-edm-sdk 0.6.0-alpha

package/dist/extractors/domain-extractors.js

@@ -0,0 +1,173 @@
+/**
+ * Domain Extractors for EDM v0.6.0
+ * Populates domains not handled by LLM extraction
+ * Supports profile-aware artifact assembly
+ */
+import { randomUUID } from "crypto";
+// =============================================================================
+// META Domain
+// =============================================================================
+export function createMeta(metadata, sourceType, profile = "full") {
+    return {
+        id: randomUUID(),
+        version: "0.6.0-alpha",
+        profile,
+        created_at: new Date().toISOString(),
+        updated_at: null,
+        locale: metadata.locale ?? null,
+        owner_user_id: metadata.subjectId ?? null,
+        parent_id: metadata.parentId ?? null,
+        visibility: metadata.visibility ?? "private",
+        pii_tier: metadata.piiTier ?? "moderate",
+        source_type: sourceType,
+        source_context: null,
+        consent_basis: metadata.consentBasis,
+        consent_scope: null,
+        consent_revoked_at: null,
+        tags: metadata.tags ?? [],
+    };
+}
+// =============================================================================
+// GOVERNANCE Domain
+// =============================================================================
+export function createGovernance(metadata) {
+    // Default subject rights based on jurisdiction
+    const defaultRights = getDefaultSubjectRights(metadata.jurisdiction ?? null);
+    return {
+        jurisdiction: metadata.jurisdiction ?? null,
+        retention_policy: {
+            basis: "user_defined",
+            ttl_days: null, // No automatic expiry by default
+            on_expiry: "soft_delete",
+        },
+        subject_rights: defaultRights,
+        exportability: "allowed",
+        k_anonymity: {
+            k: null,
+            groups: [],
+        },
+        policy_labels: determinePolicyLabels(metadata.piiTier),
+        masking_rules: [],
+    };
+}
+function getDefaultSubjectRights(jurisdiction) {
+    // GDPR and similar provide strong rights
+    if (jurisdiction === "GDPR" || jurisdiction === "LGPD") {
+        return {
+            portable: true,
+            erasable: true,
+            explainable: true,
+        };
+    }
+    // CCPA provides most rights
+    if (jurisdiction === "CCPA") {
+        return {
+            portable: true,
+            erasable: true,
+            explainable: false,
+        };
+    }
+    // HIPAA is strict on health data
+    if (jurisdiction === "HIPAA") {
+        return {
+            portable: true,
+            erasable: true,
+            explainable: true,
+        };
+    }
+    // Default: provide basic rights
+    return {
+        portable: true,
+        erasable: true,
+        explainable: false,
+    };
+}
+function determinePolicyLabels(piiTier) {
+    if (!piiTier || piiTier === "none") {
+        return ["none"];
+    }
+    if (piiTier === "extreme" || piiTier === "high") {
+        return ["sensitive"];
+    }
+    return [];
+}
+// =============================================================================
+// TELEMETRY Domain
+// =============================================================================
+export function createTelemetry(confidence, model, notes, provider) {
+    return {
+        entry_confidence: confidence,
+        extraction_model: model,
+        extraction_provider: provider ?? null,
+        extraction_notes: notes,
+        alignment_delta: null, // Populated by downstream systems
+    };
+}
+// =============================================================================
+// SYSTEM Domain
+// =============================================================================
+export function createSystem() {
+    // System domain is populated by downstream systems (embedding, indexing)
+    // SDK creates empty structure
+    return {
+        embeddings: [],
+        indices: {
+            waypoint_ids: [],
+            sector_weights: {
+                episodic: 0,
+                semantic: 0,
+                procedural: 0,
+                emotional: 0,
+                reflective: 0,
+            },
+        },
+    };
+}
+// =============================================================================
+// CROSSWALKS Domain
+// =============================================================================
+export function createCrosswalks(extracted) {
+    // Map emotion_primary to Plutchik
+    const plutchikMapping = {
+        joy: "joy",
+        sadness: "sadness",
+        fear: "fear",
+        anger: "anger",
+        wonder: "surprise", // Plutchik uses surprise
+        peace: "trust", // Closest Plutchik equivalent
+        tenderness: "trust",
+        reverence: "trust",
+    };
+    const emotionPrimary = extracted.constellation.emotion_primary;
+    const plutchikPrimary = emotionPrimary ? (plutchikMapping[emotionPrimary] ?? null) : null;
+    // Map memory_type to HMD_v2
+    const hmdMapping = {
+        legacy_artifact: "autobiographical",
+        fleeting_moment: "episodic",
+        milestone: "flashbulb",
+        reflection: "semantic",
+        formative_experience: "autobiographical",
+    };
+    const memoryType = extracted.constellation.memory_type;
+    const hmdType = memoryType ? (hmdMapping[memoryType] ?? null) : null;
+    return {
+        plutchik_primary: plutchikPrimary,
+        geneva_emotion_wheel: null, // Requires more complex mapping
+        DSM5_specifiers: null, // Should not be auto-populated
+        HMD_v2_memory_type: hmdType,
+        ISO_27557_labels: null, // Future standard
+    };
+}
+// =============================================================================
+// Source Type Detection
+// =============================================================================
+export function detectSourceType(hasText, hasImage) {
+    if (hasText && hasImage) {
+        return "mixed";
+    }
+    if (hasImage) {
+        return "image";
+    }
+    return "text";
+}
+//# sourceMappingURL=domain-extractors.js.map

package/dist/extractors/domain-extractors.js.map

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

package/dist/extractors/image-analyzer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Image Context Analyzer for EDM v0.4.0
+ * Extracts grounding context from images to supplement text extraction
+ */
+import Anthropic from "@anthropic-ai/sdk";
+export interface ImageContext {
+    /** Detected location or setting */
+    location: string | null;
+    /** Identified people or roles */
+    people: string[];
+    /** Symbolic objects or elements */
+    symbols: string[];
+    /** Event type detected */
+    eventType: string | null;
+    /** Temporal cues (era, season, time of day) */
+    temporalCues: string | null;
+    /** Overall emotional tone */
+    emotionalTone: string | null;
+}
+/**
+ * Analyze an image to extract grounding context
+ */
+export declare function analyzeImage(client: Anthropic, imageBase64: string, mediaType?: "image/jpeg" | "image/png" | "image/gif" | "image/webp", model?: string): Promise<ImageContext>;
+/**
+ * Merge image context into extracted fields
+ * Image provides grounding, text takes priority for interpretation
+ */
+export declare function mergeImageContext(extracted: {
+    milky_way: {
+        location_context: string | null;
+        associated_people: string[];
+        event_type: string | null;
+    };
+    constellation: {
+        symbolic_anchor: string | null;
+    };
+}, imageContext: ImageContext): void;
+//# sourceMappingURL=image-analyzer.d.ts.map

package/dist/extractors/image-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-analyzer.d.ts","sourceRoot":"","sources":["../../src/extractors/image-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6BAA6B;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAsBD;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,YAA2B,EACjF,KAAK,GAAE,MAAmC,GACzC,OAAO,CAAC,YAAY,CAAC,CAmDvB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE;IACT,SAAS,EAAE;QAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACvG,aAAa,EAAE;QAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACnD,EACD,YAAY,EAAE,YAAY,GACzB,IAAI,CAyBN"}

package/dist/extractors/image-analyzer.js

@@ -0,0 +1,101 @@
+const IMAGE_ANALYSIS_PROMPT = `
+Analyze this image to extract context for an emotional memory. Return ONLY a JSON object with these fields:
+
+{
+  "location": "place or setting visible (or null)",
+  "people": ["list of people/roles visible"],
+  "symbols": ["symbolic objects, artifacts, or meaningful elements"],
+  "eventType": "type of event if discernible (or null)",
+  "temporalCues": "era, season, time indicators (or null)",
+  "emotionalTone": "overall mood conveyed by the image (or null)"
+}
+
+Rules:
+- Only extract what is visually evident
+- Do not invent or assume
+- Use lowercase except for proper names
+- Keep descriptions brief (1-3 words each)
+- Return valid JSON only, no commentary
+`;
+/**
+ * Analyze an image to extract grounding context
+ */
+export async function analyzeImage(client, imageBase64, mediaType = "image/jpeg", model = "claude-sonnet-4-20250514") {
+    const response = await client.messages.create({
+        model,
+        max_tokens: 1024,
+        messages: [
+            {
+                role: "user",
+                content: [
+                    {
+                        type: "image",
+                        source: {
+                            type: "base64",
+                            media_type: mediaType,
+                            data: imageBase64,
+                        },
+                    },
+                    {
+                        type: "text",
+                        text: IMAGE_ANALYSIS_PROMPT,
+                    },
+                ],
+            },
+        ],
+    });
+    const textBlock = response.content.find((block) => block.type === "text");
+    if (!textBlock || textBlock.type !== "text") {
+        throw new Error("No text response from image analysis");
+    }
+    try {
+        const parsed = JSON.parse(textBlock.text);
+        return {
+            location: parsed.location ?? null,
+            people: Array.isArray(parsed.people) ? parsed.people : [],
+            symbols: Array.isArray(parsed.symbols) ? parsed.symbols : [],
+            eventType: parsed.eventType ?? null,
+            temporalCues: parsed.temporalCues ?? null,
+            emotionalTone: parsed.emotionalTone ?? null,
+        };
+    }
+    catch {
+        // Return empty context on parse failure
+        return {
+            location: null,
+            people: [],
+            symbols: [],
+            eventType: null,
+            temporalCues: null,
+            emotionalTone: null,
+        };
+    }
+}
+/**
+ * Merge image context into extracted fields
+ * Image provides grounding, text takes priority for interpretation
+ */
+export function mergeImageContext(extracted, imageContext) {
+    // Only fill null fields - text takes priority
+    if (!extracted.milky_way.location_context && imageContext.location) {
+        extracted.milky_way.location_context = imageContext.location;
+    }
+    // Merge people lists
+    if (imageContext.people.length > 0) {
+        const existingLower = extracted.milky_way.associated_people.map((p) => p.toLowerCase());
+        for (const person of imageContext.people) {
+            if (!existingLower.includes(person.toLowerCase())) {
+                extracted.milky_way.associated_people.push(person);
+            }
+        }
+    }
+    // Event type from image if not in text
+    if (!extracted.milky_way.event_type && imageContext.eventType) {
+        extracted.milky_way.event_type = imageContext.eventType;
+    }
+    // Symbolic anchor from image symbols
+    if (!extracted.constellation.symbolic_anchor && imageContext.symbols.length > 0) {
+        extracted.constellation.symbolic_anchor = imageContext.symbols[0] ?? null;
+    }
+}
+//# sourceMappingURL=image-analyzer.js.map

package/dist/extractors/image-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-analyzer.js","sourceRoot":"","sources":["../../src/extractors/image-analyzer.ts"],"names":[],"mappings":"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"}

package/dist/extractors/kimi-extractor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Kimi K2 Extractor for EDM v0.6.0
+ * Uses MoonshotAI's Kimi K2 model via OpenAI-compatible API
+ * Supports profile-aware extraction (core/extended/full)
+ */
+import OpenAI from "openai";
+import type { ExtractionInput, EdmProfile } from "../schema/types.js";
+import { type LlmExtractionResult } from "./llm-extractor.js";
+/**
+ * Extract EDM fields from content using Kimi K2
+ */
+export declare function extractWithKimi(client: OpenAI, input: ExtractionInput, model?: string, profile?: EdmProfile): Promise<LlmExtractionResult>;
+/**
+ * Create a Kimi client using MoonshotAI's direct API
+ * Falls back to OpenRouter if direct API key is not available
+ */
+export declare function createKimiClient(apiKey?: string): OpenAI;
+/**
+ * Get the appropriate model ID based on which client is being used
+ */
+export declare function getKimiModelId(): string;
+//# sourceMappingURL=kimi-extractor.d.ts.map

package/dist/extractors/kimi-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kimi-extractor.d.ts","sourceRoot":"","sources":["../../src/extractors/kimi-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAsB,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE1F,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAmB5B;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,eAAe,EACtB,KAAK,GAAE,MAA2B,EAClC,OAAO,GAAE,UAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAkF9B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA2BxD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAMvC"}

package/dist/extractors/kimi-extractor.js

@@ -0,0 +1,137 @@
+/**
+ * Kimi K2 Extractor for EDM v0.6.0
+ * Uses MoonshotAI's Kimi K2 model via OpenAI-compatible API
+ * Supports profile-aware extraction (core/extended/full)
+ */
+import OpenAI from "openai";
+import { LlmExtractedFieldsSchema } from "../schema/edm-schema.js";
+import { EXTRACTION_SYSTEM_PROMPT, } from "./llm-extractor.js";
+import { getProfilePrompt, calculateProfileConfidence } from "./profile-prompts.js";
+/**
+ * Default Kimi K2 model identifier
+ * MoonshotAI exposes this via their OpenAI-compatible endpoint
+ */
+const DEFAULT_KIMI_MODEL = "kimi-k2-0711-preview";
+/**
+ * Kimi API base URLs
+ * - Direct: api.moonshot.cn or api.moonshot.ai (requires MOONSHOT_API_KEY or KIMI_API_KEY)
+ * - OpenRouter: openrouter.ai (requires OPENROUTER_API_KEY)
+ * Set MOONSHOT_BASE_URL env var to override the default
+ */
+const DEFAULT_KIMI_BASE_URL = "https://api.moonshot.cn/v1";
+const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
+const OPENROUTER_KIMI_MODEL = "moonshotai/kimi-k2";
+/**
+ * Extract EDM fields from content using Kimi K2
+ */
+export async function extractWithKimi(client, input, model = DEFAULT_KIMI_MODEL, profile = "full") {
+    const userContent = [];
+    // Add text content
+    if (input.text) {
+        userContent.push({
+            type: "text",
+            text: input.text,
+        });
+    }
+    // Add image if provided (OpenAI-compatible format)
+    if (input.image) {
+        const mediaType = input.imageMediaType ?? "image/jpeg";
+        userContent.push({
+            type: "image_url",
+            image_url: {
+                url: `data:${mediaType};base64,${input.image}`,
+            },
+        });
+    }
+    // Select profile-specific prompt or use full extraction prompt
+    const profilePrompt = getProfilePrompt(profile);
+    const systemPrompt = profilePrompt || EXTRACTION_SYSTEM_PROMPT;
+    const response = await client.chat.completions.create({
+        model,
+        max_tokens: 4096,
+        messages: [
+            {
+                role: "system",
+                content: systemPrompt,
+            },
+            {
+                role: "user",
+                content: userContent,
+            },
+        ],
+    });
+    // Extract text response
+    const text = response.choices[0]?.message?.content;
+    if (!text) {
+        throw new Error("No text response from Kimi K2");
+    }
+    // Parse JSON response (strip markdown code fences if present)
+    let jsonText = text.trim();
+    const fenceMatch = jsonText.match(/^```(?:json)?\s*\n?([\s\S]*?)\n?\s*```$/);
+    if (fenceMatch?.[1]) {
+        jsonText = fenceMatch[1].trim();
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonText);
+    }
+    catch {
+        throw new Error(`Failed to parse Kimi response as JSON: ${text.slice(0, 200)}...`);
+    }
+    // Validate against schema
+    const result = LlmExtractedFieldsSchema.safeParse(parsed);
+    if (!result.success) {
+        const errorDetails = result.error.errors
+            .map((e) => `${e.path.join(".")}: ${e.message}`)
+            .join("; ");
+        throw new Error(`Kimi response failed schema validation: ${errorDetails}`);
+    }
+    // Calculate profile-aware confidence
+    const confidence = calculateProfileConfidence(result.data, profile);
+    return {
+        extracted: result.data,
+        confidence,
+        model,
+        profile,
+        notes: null,
+    };
+}
+/**
+ * Create a Kimi client using MoonshotAI's direct API
+ * Falls back to OpenRouter if direct API key is not available
+ */
+export function createKimiClient(apiKey) {
+    // Try direct MoonshotAI API first
+    const directKey = apiKey ?? process.env["MOONSHOT_API_KEY"] ?? process.env["KIMI_API_KEY"];
+    if (directKey) {
+        const baseURL = process.env["MOONSHOT_BASE_URL"] ?? DEFAULT_KIMI_BASE_URL;
+        return new OpenAI({
+            apiKey: directKey,
+            baseURL,
+        });
+    }
+    // Fall back to OpenRouter
+    const openRouterKey = process.env["OPENROUTER_API_KEY"];
+    if (openRouterKey) {
+        return new OpenAI({
+            apiKey: openRouterKey,
+            baseURL: OPENROUTER_BASE_URL,
+            defaultHeaders: {
+                "HTTP-Referer": "https://deepadata.com",
+                "X-Title": "DeepaData EDM Extraction",
+            },
+        });
+    }
+    throw new Error("Kimi API key is required. Set MOONSHOT_API_KEY, KIMI_API_KEY, or OPENROUTER_API_KEY environment variable.");
+}
+/**
+ * Get the appropriate model ID based on which client is being used
+ */
+export function getKimiModelId() {
+    // If using OpenRouter, use their model identifier
+    if (process.env["OPENROUTER_API_KEY"] && !process.env["MOONSHOT_API_KEY"] && !process.env["KIMI_API_KEY"]) {
+        return OPENROUTER_KIMI_MODEL;
+    }
+    return DEFAULT_KIMI_MODEL;
+}
+//# sourceMappingURL=kimi-extractor.js.map

package/dist/extractors/kimi-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kimi-extractor.js","sourceRoot":"","sources":["../../src/extractors/kimi-extractor.ts"],"names":[],"mappings":"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"}

package/dist/extractors/llm-extractor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * LLM Extractor for EDM v0.6.0
+ * Uses Anthropic Claude to extract emotional data from content
+ * Supports profile-aware extraction (core/extended/full)
+ */
+import Anthropic from "@anthropic-ai/sdk";
+import type { LlmExtractedFields, ExtractionInput, EdmProfile } from "../schema/types.js";
+/**
+ * System prompt for EDM extraction - Updated for v0.4.0 canonical schema
+ * Reconciled field names from system-prompt-B.ts:
+ * - archetype_energy → narrative_archetype
+ * - meaning_inference → expressed_insight
+ * - transcendent_moment → transformational_pivot
+ * - REMOVED: active_motivational_state, media_context, memory_layers, tether_target, moral_valence
+ * - reentry_score → recurrence_pattern (type changed: number → enum)
+ * - ADDED: somatic_signature
+ */
+export declare const EXTRACTION_SYSTEM_PROMPT = "\nYou classify emotionally rich memories into a JSON object. Input may include text and an image.\n\nRules\n- Fuse text + image. Treat text as primary; use image only to add grounded specifics (place, event, symbols, people).\n- Keep fields to single words or short phrases (1\u20133 words). Only \"narrative\" is multi-sentence (3\u20135).\n- No invention. If not supported by input, use null.\n- Always include every top-level key and sub-key from the schema, even if the value is null or an empty array.\n- Do not omit fields; if unknown, return null.\n- Output JSON only \u2014 no commentary, markdown, or extra text.\n- If motivation is ambiguous, choose the most conservative option (e.g., \"curiosity\" vs \"fear\") or return null.\n\nCRITICAL: Enum Field Constraints\n- Many fields below are STRICT ENUMS with a fixed set of allowed values.\n- You MUST use ONLY the values listed in the enum sets. Do not invent similar values.\n- Cross-contamination warning: Each enum field has its own distinct value set. Do not use values from one field in another.\n  Example: \"milestone\" is valid for memory_type but NOT for narrative_arc.\n  Example: \"confront\" is valid for both drive_state and coping_style - check which field you're populating.\n- If none of the allowed enum values adequately capture the expressed content, use the closest match. Do not invent alternatives.\n\nNormalization (very important)\n- Emit lowercase for all string fields except proper names in arrays like associated_people.\n- For array fields (emotion_subtone, recall_triggers, retrieval_keys, nearby_themes, resilience_markers, associated_people):\n  \u2022 use short tokens/phrases without punctuation;\n  \u2022 avoid duplicates;\n  \u2022 prefer singular nouns where reasonable (\"tradition\" not \"traditions\").\n- Never put boolean-like strings (\"true\"/\"false\") into fields that are boolean; use real booleans.\n\nSchema\n{\n  \"core\": {\n    \"anchor\": \"\",            // central theme (e.g., \"dad's toolbox\", \"nana's traditions\")\n    \"spark\": \"\",             // what triggered the memory (e.g., \"finding the cassette\", \"first snow\")\n    \"wound\": \"\",             // The specific vulnerability, loss, or pain present \u2014 NOT generic labels like 'loss' or 'grief' but what exactly was lost or why it hurts. Examples: 'unlived travel dream', 'war silence never spoken', 'father died before I knew him', 'shame of not fitting in'. If no wound is present, use null.\n    \"fuel\": \"\",              // what energized the experience (e.g., \"shared laughter\", \"curiosity\")\n    \"bridge\": \"\",            // connection between past and present (e.g., \"replaying old tape\", \"returning to the porch\")\n    \"echo\": \"\",              // what still resonates (e.g., \"her laugh\", \"smell of oil\", \"city lights on water\")\n    \"narrative\": \"\"          // 3\u20135 sentences; include \u22651 sensory detail, \u22651 temporal cue, and a symbolic callback; faithful and concise\n  },\n  \"constellation\": {\n    \"emotion_primary\": \"\",           // STRICT ENUM: joy | sadness | fear | anger | wonder | peace | tenderness | reverence | pride | anxiety | gratitude | longing | hope (pick best-fit from these 13 ONLY)\n    \"emotion_subtone\": [],           // 2\u20134 short words (e.g., bittersweet, grateful) \u2014 free text array\n    \"higher_order_emotion\": \"\",      // free text: e.g., awe, forgiveness, pride, moral_elevation (or null)\n    \"meta_emotional_state\": \"\",      // free text: e.g., acceptance, confusion, curiosity (or null)\n    \"interpersonal_affect\": \"\",      // free text: e.g., warmth, openness, defensiveness (or null)\n    \"narrative_arc\": \"\",             // STRICT ENUM: overcoming | transformation | connection | reflection | closure (pick ONE or null)\n    \"relational_dynamics\": \"\",       // STRICT ENUM: parent_child | romantic_partnership | sibling_bond | family | friendship | companionship | mentorship | reunion | community_ritual | grief | self_reflection | professional | therapeutic | service | adversarial (pick ONE)\n    \"temporal_context\": \"\",          // STRICT ENUM: childhood | early_adulthood | midlife | late_life | recent | future | timeless (pick ONE or null)\n    \"memory_type\": \"\",               // STRICT ENUM: legacy_artifact | fleeting_moment | milestone | reflection | formative_experience (pick ONE or null)\n    \"media_format\": \"\",              // photo, video, audio, text, photo_with_story (or null)\n    \"narrative_archetype\": \"\",       // STRICT ENUM: hero | caregiver | seeker | sage | lover | outlaw | innocent | magician | creator | everyman | jester | ruler | mentor (pick ONE or null; lowercase)\n    \"symbolic_anchor\": \"\",           // concrete object/place/ritual (or null)\n    \"relational_perspective\": \"\",    // STRICT ENUM: self | partner | family | friends | community | humanity (pick ONE or null)\n    \"temporal_rhythm\": \"\",           // STRICT ENUM: still | sudden | rising | fading | recurring | spiraling | dragging | suspended | looping | cyclic (pick ONE or null)\n    \"identity_thread\": \"\",           // short sentence\n    \"expressed_insight\": \"\",         // brief insight explicitly stated by subject (extracted, not inferred)\n    \"transformational_pivot\": false, // true if subject explicitly identifies this as life-changing\n    \"somatic_signature\": \"\"          // bodily sensations explicitly described (e.g., \"chest tightness\", \"warmth spreading\") or null\n  },\n  \"milky_way\": {\n    \"event_type\": \"\",                // e.g., family gathering, farewell, birthday (or null)\n    \"location_context\": \"\",          // place from text or image (or null)\n    \"associated_people\": [],         // names or roles (proper case allowed)\n    \"visibility_context\": \"\",        // STRICT ENUM: private | family_only | shared_publicly (pick ONE or null)\n    \"tone_shift\": \"\"                 // e.g., loss to gratitude (or null)\n  },\n  \"gravity\": {\n    \"emotional_weight\": 0.0,         // 0.0\u20131.0 (felt intensity IN THE MOMENT)\n    \"emotional_density\": \"\",         // STRICT ENUM: low | medium | high (pick ONE or null)\n    \"valence\": \"\",                   // STRICT ENUM: positive | negative | mixed (pick ONE or null)\n    \"viscosity\": \"\",                 // STRICT ENUM: low | medium | high | enduring | fluid (pick ONE or null)\n    \"gravity_type\": \"\",              // short phrase (e.g., symbolic resonance)\n    \"tether_type\": \"\",               // STRICT ENUM: person | symbol | event | place | ritual | object | tradition | identity | self (pick ONE or null)\n    \"recall_triggers\": [],           // sensory or symbolic cues (lowercase tokens)\n    \"retrieval_keys\": [],            // compact hooks (3\u20136 tokens recommended)\n    \"nearby_themes\": [],             // adjacent concepts\n    \"legacy_embed\": false,\n    \"recurrence_pattern\": \"\",        // STRICT ENUM: cyclical | isolated | chronic | emerging (pick ONE or null)\n    \"strength_score\": 0.0,           // 0.0\u20131.0 (how BOUND/STUCK this memory is)\n    \"temporal_decay\": \"\",            // STRICT ENUM: fast | moderate | slow (pick ONE or null)\n    \"resilience_markers\": [],        // 1\u20133 (e.g., acceptance, optimism, continuity)\n    \"adaptation_trajectory\": \"\"      // STRICT ENUM: improving | stable | declining | integrative | emerging (pick ONE or null)\n  },\n  \"impulse\": {\n    \"primary_energy\": \"\",              // free text: e.g., curiosity, fear, compassion (or null; lowercase)\n    \"drive_state\": \"\",                 // STRICT ENUM: explore | approach | avoid | repair | persevere | share | confront | protect | process (pick ONE or null)\n    \"motivational_orientation\": \"\",    // STRICT ENUM: belonging | safety | mastery | meaning | autonomy (pick ONE or null)\n    \"temporal_focus\": \"\",              // STRICT ENUM: past | present | future (pick ONE or null)\n    \"directionality\": \"\",              // STRICT ENUM: inward | outward | transcendent (pick ONE or null)\n    \"social_visibility\": \"\",           // STRICT ENUM: private | relational | collective (pick ONE or null)\n    \"urgency\": \"\",                     // STRICT ENUM: calm | elevated | pressing | acute (pick ONE or null)\n    \"risk_posture\": \"\",                // STRICT ENUM: cautious | balanced | bold (pick ONE or null)\n    \"agency_level\": \"\",                // STRICT ENUM: low | medium | high (pick ONE or null)\n    \"regulation_state\": \"\",            // STRICT ENUM: regulated | wavering | dysregulated (pick ONE or null)\n    \"attachment_style\": \"\",            // STRICT ENUM: secure | anxious | avoidant | disorganized (pick ONE or null)\n    \"coping_style\": \"\"                 // STRICT ENUM: reframe_meaning | seek_support | distract | ritualize | confront | detach | process (pick ONE or null)\n  }\n\n  // Calibration \u2014 Impulse (helps apply the fields consistently)\n  // - temporal_focus: past (reminisce), present (here-and-now coping), future (plans/longing).\n  // - directionality: inward (self-processing), outward (toward others), transcendent (beyond self).\n  // - social_visibility: private (to self or 1:1), relational (friends/family), collective (community-wide).\n  // - If uncertain, choose the most conservative option or null.\n\n  // CROSS-CONTAMINATION DISAMBIGUATION (read carefully)\n  //\n  // temporal_rhythm vs urgency:\n  //   - temporal_rhythm describes the CADENCE or PACE of time in the memory experience\n  //     (still, sudden, rising, fading, recurring, spiraling, dragging, suspended, looping, cyclic)\n  //   - urgency describes the INTENSITY of motivational pressure RIGHT NOW\n  //     (calm, elevated, pressing, acute)\n  //   - \"pressing\" belongs ONLY in urgency, NEVER in temporal_rhythm\n  //\n  // temporal_rhythm vs viscosity:\n  //   - temporal_rhythm is about TIME MOVEMENT in the memory\n  //   - viscosity is about EMOTIONAL PERSISTENCE over time\n  //     (low=fleeting, medium=moderate, high=sticky, enduring=long-lasting, fluid=changeable)\n  //   - \"enduring\" belongs ONLY in viscosity, NEVER in temporal_rhythm\n  //\n  // relational_dynamics vs relational_perspective:\n  //   - relational_dynamics: the TYPE of relationship (parent_child, friendship, mentorship, etc.)\n  //   - relational_perspective: WHOSE viewpoint the narrative is told from (self, partner, family, etc.)\n  //   - \"family\" can appear in BOTH fields with different meanings\n  //\n  // drive_state vs coping_style:\n  //   - drive_state: the MOTIVATIONAL direction (explore, approach, avoid, confront, etc.)\n  //   - coping_style: the STRATEGY for managing emotions (reframe_meaning, seek_support, confront, etc.)\n  //   - \"confront\" is valid in BOTH - use drive_state for action impulse, coping_style for emotion management\n  //\n  // emotion_primary (STRICT ENUM) vs higher_order_emotion (free text):\n  //   - emotion_primary MUST be one of the 13 listed values ONLY\n  //   - Do NOT put free-text emotions like \"compassion\", \"reflection\", \"frustration\" in emotion_primary\n  //   - Use higher_order_emotion for complex emotions not in the primary list\n  //\n  // narrative_arc (CRITICAL - common error):\n  //   - Describes the STORY TRAJECTORY (overcoming, transformation, connection, reflection, closure)\n  //   - \"confrontation\" is NOT a valid arc \u2014 it describes an event/scene, not a trajectory\n  //   - If the story involves confronting something, use \"overcoming\" (challenge faced and resolved)\n  //     or \"transformation\" (fundamental change through conflict)\n  //   - \"confront\" belongs in drive_state or coping_style, NOT in narrative_arc\n  //\n  // emotional_weight vs strength_score (CRITICAL - different concepts):\n  //   - emotional_weight: The felt INTENSITY of the experience in the moment.\n  //     A heated argument = high weight (0.8). A routine check-in = low weight (0.2).\n  //   - strength_score: How BOUND/STUCK this memory is \u2014 through association, ritual, retelling, or identity.\n  //     A childhood memory retold for decades = high strength (0.9) even if emotional weight was moderate.\n  //     A customer complaint = may have high weight (0.8) but low strength (0.3) \u2014 intense but fades quickly.\n  //   - These should NOT always correlate.\n  //     Ask: \"How heavy does this feel RIGHT NOW?\" (weight) vs \"How stuck/persistent is this memory?\" (strength)\n  //\n  // SYNONYM CORRECTIONS (use the canonical form):\n  //   - drive_state: Use \"process\" NOT \"reflect\". The enum value is \"process\" for internal processing/reflection.\n  //   - narrative_archetype: Use \"caregiver\" NOT \"caretaker\". The Jungian archetype label is \"caregiver\".\n}\n";
+export interface LlmExtractionResult {
+    extracted: LlmExtractedFields;
+    confidence: number;
+    model: string;
+    profile: EdmProfile;
+    notes: string | null;
+}
+/**
+ * Extract EDM fields from content using Anthropic Claude
+ *
+ * @param client - Anthropic client
+ * @param input - Content to extract from
+ * @param model - Model to use (default: claude-sonnet-4-20250514)
+ * @param profile - EDM profile (default: 'full')
+ */
+export declare function extractWithLlm(client: Anthropic, input: ExtractionInput, model?: string, profile?: EdmProfile): Promise<LlmExtractionResult>;
+/**
+ * Calculate extraction confidence based on field population
+ */
+export declare function calculateConfidence(extracted: LlmExtractedFields): number;
+/**
+ * Create an Anthropic client
+ */
+export declare function createAnthropicClient(apiKey?: string): Anthropic;
+//# sourceMappingURL=llm-extractor.d.ts.map

package/dist/extractors/llm-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-extractor.d.ts","sourceRoot":"","sources":["../../src/extractors/llm-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAI1F;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,ijZA0JpC,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,eAAe,EACtB,KAAK,GAAE,MAAmC,EAC1C,OAAO,GAAE,UAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAgF9B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,kBAAkB,GAAG,MAAM,CA6CzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAIhE"}