deepadata-edm-sdk 0.8.8 → 0.8.10

package/dist/extractors/generate-field-block.js

@@ -0,0 +1,253 @@
+/**
+ * JSON-Schema → prompt field-block generator (ADR-0030, amended — Step 6).
+ *
+ * Reads the PUBLISHED edm-spec package (the source of truth, ADR-0030 amended)
+ * rather than walking the SDK's own zod validator. The two extraction prompts
+ * (Full in llm-extractor.ts; Extended/Essential in profile-prompts.ts) each
+ * carry a hand-written JSON skeleton whose per-field `// CANONICAL:` / `// STRICT
+ * ENUM:` comments enumerate the field vocabulary. This generator emits that
+ * skeleton FROM the spec's JSON Schema fragments, so the vocabulary rendered in
+ * each comment is the one the spec enforces — drift between prompt, validator,
+ * and spec becomes impossible by construction.
+ *
+ * Phase A walked the local zod schema; this is the spec-sourced port. The OUTPUT
+ * FORMAT is unchanged — byte-for-byte identical to what Phase A emitted (and
+ * therefore to the hand-written skeletons it reproduces). Only the INPUT source
+ * moved: zod nodes → edm-spec JSON Schema.
+ *
+ * Classification maps directly from JSON Schema to the kinds the prompt renders:
+ *   - "x-edm-canonical": [...]  → canonical-enum (two-tier; free text accepted)
+ *   - "enum": [...]             → strict-enum    (validator rejects non-members)
+ *   - bare "type" string/number/boolean/array → free text / number / boolean / array
+ *
+ * Field MEMBERSHIP and ORDER per profile come from the composite profile schemas
+ * (edm-spec/schema/edm.v0.8.{essential,extended,full}.schema.json): which
+ * representational domains a profile includes, and — for inline domains — which
+ * fields, in which order. This is the role the SDK's LlmEssential/LlmExtended/
+ * LlmExtractedFields zod schemas used to play.
+ *
+ * Field DEFINITIONS (classification + canonical value lists) are always read from
+ * the fragments, never from the composite's inline copies, so the canonical
+ * vocabulary rendered in each comment is the one the fragment enforces.
+ */
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const loadJson = (specPath) => JSON.parse(readFileSync(require.resolve(specPath), "utf8"));
+// ---------------------------------------------------------------------------
+// Profile / domain wiring
+// ---------------------------------------------------------------------------
+/** The LLM-extracted representational domains, in canonical (zod definition) order. */
+const LLM_DOMAINS = ["core", "constellation", "milky_way", "gravity", "impulse"];
+const FRAGMENT_SPEC = {
+    core: "edm-spec/schema/fragments/core.json",
+    constellation: "edm-spec/schema/fragments/constellation.json",
+    milky_way: "edm-spec/schema/fragments/milky_way.json",
+    gravity: "edm-spec/schema/fragments/gravity.json",
+    impulse: "edm-spec/schema/fragments/impulse.json",
+};
+const COMPOSITE_SPEC = {
+    essential: "edm-spec/schema/edm.v0.8.essential.schema.json",
+    extended: "edm-spec/schema/edm.v0.8.extended.schema.json",
+    full: "edm-spec/schema/edm.v0.8.full.schema.json",
+};
+const loadFragment = (domain) => loadJson(FRAGMENT_SPEC[domain]);
+/**
+ * experiential_stance is a top-level extraction-only field — never sealed into
+ * the artifact body, so it appears in no fragment or composite schema. The SDK
+ * carries it as ExperientialStanceSchema (z.enum). Mirror it here as a strict
+ * enum so the generated block asks for it exactly as the current prompts do.
+ */
+const EXPERIENTIAL_STANCE_DEF = {
+    enum: ["lived", "witnessed", "quoted_third_party", "assistant_generated", "hypothetical"],
+};
+/**
+ * Classify a JSON Schema field node into the kind the prompt comment renders.
+ *
+ * - "x-edm-canonical": [...]  → canonical-enum (two-tier free text)
+ * - "enum": [...]             → strict-enum (null stripped)
+ * - type number/integer       → number
+ * - type boolean              → boolean
+ * - type array                → string-array
+ * - otherwise (string/null)   → free text
+ */
+export function classifyField(def) {
+    const canonical = def["x-edm-canonical"];
+    if (Array.isArray(canonical)) {
+        return { kind: "canonical-enum", enumValues: canonical };
+    }
+    if (Array.isArray(def.enum)) {
+        // JSON Schema enums carry a trailing `null` for nullable fields; zod models
+        // nullability with `.nullable()` and keeps it out of the enum, so strip it.
+        return { kind: "strict-enum", enumValues: def.enum.filter((v) => v !== null) };
+    }
+    const types = Array.isArray(def.type) ? def.type : [def.type];
+    if (types.includes("number") || types.includes("integer"))
+        return { kind: "number" };
+    if (types.includes("boolean"))
+        return { kind: "boolean" };
+    if (types.includes("array"))
+        return { kind: "string-array" };
+    return { kind: "string" };
+}
+// ---------------------------------------------------------------------------
+// Presentation layer (OUTPUT_CONTRACT — hand-written, §4)
+//
+// Canonical comment conventions follow the Full prompt (the richest of the
+// three current skeletons): STRICT/CANONICAL prefixes with explicit suffixes
+// and per-field prose guidance for free-text fields. Enum VALUES are NEVER in
+// these tables — they come from the fragment.
+// ---------------------------------------------------------------------------
+const STRICT_SUFFIX = " (pick ONE or null)";
+const CANONICAL_SUFFIX = " (free text accepted if none fits)";
+/** Per-field suffix overrides for strict enums (keyed `domain.field`). */
+const SUFFIX_OVERRIDE = {
+    "constellation.narrative_archetype": " (pick ONE or null; lowercase)",
+};
+/** Extra prose appended after a canonical-enum comment. */
+const CANONICAL_TRAILING = {
+    "constellation.arc_type": ". gratitude = moments of thankfulness, appreciation, acknowledging blessing; authenticity = feeling fully oneself, self-alignment, identity congruence",
+};
+/** Prose guidance for non-enum (free text / number / boolean / array) fields. */
+const GUIDANCE = {
+    // core
+    "core.anchor": 'central theme (e.g., "dad\'s toolbox", "nana\'s traditions")',
+    "core.spark": 'what triggered the memory (e.g., "finding the cassette", "first snow")',
+    "core.wound": "The specific vulnerability, loss, or pain present — 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.",
+    "core.fuel": 'what energized the experience (e.g., "shared laughter", "curiosity")',
+    "core.bridge": 'connection between past and present (e.g., "replaying old tape", "returning to the porch")',
+    "core.echo": 'what still resonates (e.g., "her laugh", "smell of oil", "city lights on water")',
+    "core.narrative": "3–5 sentences. REQUIRED: include ALL of the following — ≥1 concrete sensory detail (sight, sound, smell, texture), ≥1 temporal cue that anchors the memory in time, ≥1 symbolic callback that connects past to present. Write from the subject's perspective. Do not compress or summarise — give the memory space to breathe. Faithful and specific. Never generic.",
+    // constellation
+    "constellation.emotion_subtone": "2–4 short words (e.g., bittersweet, grateful) — free text array",
+    "constellation.higher_order_emotion": "free text: e.g., awe, forgiveness, pride, moral_elevation (or null)",
+    "constellation.meta_emotional_state": "free text: e.g., acceptance, confusion, curiosity (or null)",
+    "constellation.interpersonal_affect": "free text: e.g., warmth, openness, defensiveness (or null)",
+    "constellation.symbolic_anchor": "concrete object/place/ritual (or null)",
+    "constellation.identity_thread": "short sentence",
+    "constellation.expressed_insight": "brief insight explicitly stated by subject (extracted, not inferred)",
+    "constellation.transformational_pivot": "true if subject explicitly identifies this as life-changing",
+    "constellation.somatic_signature": 'bodily sensations explicitly described (e.g., "chest tightness", "warmth spreading") or null',
+    // milky_way
+    "milky_way.event_type": "e.g., family gathering, farewell, birthday (or null)",
+    "milky_way.location_context": "place from text or image (or null)",
+    "milky_way.associated_people": "names or roles (proper case allowed)",
+    "milky_way.tone_shift": "e.g., loss to gratitude (or null)",
+    // gravity
+    "gravity.emotional_weight": "0.0–1.0 (felt intensity IN THE MOMENT). Calibration: 0.9+ life-altering irreversible moments; 0.7-0.9 significant personal events with strong emotional response; 0.4-0.7 meaningful but routine emotional experiences; 0.1-0.4 mild passing emotional content",
+    "gravity.gravity_type": "short phrase (e.g., symbolic resonance)",
+    "gravity.recall_triggers": "sensory or symbolic cues (lowercase tokens)",
+    "gravity.retrieval_keys": "compact hooks (3–6 tokens recommended)",
+    "gravity.nearby_themes": "adjacent concepts",
+    "gravity.strength_score": "0.0–1.0 (how BOUND/STUCK this memory is)",
+    "gravity.resilience_markers": "1–3 (e.g., acceptance, optimism, continuity)",
+    // impulse
+    "impulse.primary_energy": "free text: e.g., curiosity, fear, compassion (or null; lowercase)",
+    // top-level
+    experiential_stance: "", // enum-driven; guidance unused
+};
+const PLACEHOLDER = {
+    "strict-enum": '""',
+    "canonical-enum": '""',
+    string: '""',
+    number: "0.0",
+    boolean: "false",
+    "string-array": "[]",
+};
+/** Build the `// ...` comment text for a field, or null if it has none. */
+function commentFor(key, info) {
+    if (info.kind === "strict-enum") {
+        const suffix = SUFFIX_OVERRIDE[key] ?? STRICT_SUFFIX;
+        return `STRICT ENUM: ${(info.enumValues ?? []).join(" | ")}${suffix}`;
+    }
+    if (info.kind === "canonical-enum") {
+        const trailing = CANONICAL_TRAILING[key] ?? "";
+        return `CANONICAL: ${(info.enumValues ?? []).join(" | ")}${CANONICAL_SUFFIX}${trailing}`;
+    }
+    const g = GUIDANCE[key];
+    return g && g.length > 0 ? g : null;
+}
+/** Join lines, aligning each block's `//` to (max content length) + 1 space. */
+function renderBlock(lines) {
+    const maxLen = lines.reduce((m, l) => Math.max(m, l.content.length), 0);
+    return lines.map((l) => {
+        if (l.comment === null)
+            return l.content;
+        const pad = " ".repeat(maxLen - l.content.length + 1);
+        return `${l.content}${pad}// ${l.comment}`;
+    });
+}
+/**
+ * Resolve a profile domain to its ordered `[fieldName, def]` pairs.
+ * Field names/order: inline composite properties when present, else fragment
+ * order. Field defs: always the fragment (source of truth), falling back to the
+ * inline composite copy only if the fragment lacks the field.
+ */
+function domainFields(compositeProp, fragment) {
+    const fragProps = fragment.properties ?? {};
+    const inlineProps = compositeProp?.properties;
+    const names = inlineProps ? Object.keys(inlineProps) : Object.keys(fragProps);
+    return names.map((name) => [name, fragProps[name] ?? inlineProps?.[name] ?? {}]);
+}
+/**
+ * Generate the JSON field-block skeleton for a profile, from the edm-spec JSON
+ * Schema.
+ *
+ * Output shape (matches the current hand-written skeletons):
+ *
+ *   {
+ *     "experiential_stance": "",  // STRICT ENUM: ...
+ *     "core": {
+ *       "anchor": "",  // central theme ...
+ *       ...
+ *     },
+ *     ...
+ *   }
+ */
+export function generateFieldBlock(profile) {
+    const compositeSpec = COMPOSITE_SPEC[profile];
+    if (!compositeSpec) {
+        throw new Error(`unknown profile "${profile}" (expected one of: ${Object.keys(COMPOSITE_SPEC).join(", ")})`);
+    }
+    const composite = loadJson(compositeSpec);
+    const props = composite.properties ?? {};
+    // Representational domains present in this profile, in canonical order.
+    const domains = LLM_DOMAINS.filter((d) => props[d]);
+    // Top-level: the experiential_stance scalar renders first and inline; domains
+    // render as nested blocks. (Mirrors the SDK's [...scalars, ...domains] order.)
+    const topLevelCount = 1 + domains.length;
+    let topIdx = 0;
+    const out = ["{"];
+    // experiential_stance (scalar)
+    {
+        const isLastTop = topIdx === topLevelCount - 1;
+        const topComma = isLastTop ? "" : ",";
+        const info = classifyField(EXPERIENTIAL_STANCE_DEF);
+        const comment = commentFor("experiential_stance", info);
+        const [rendered] = renderBlock([
+            { content: `  "experiential_stance": ${PLACEHOLDER[info.kind]}${topComma}`, comment },
+        ]);
+        out.push(rendered);
+        topIdx++;
+    }
+    for (const domain of domains) {
+        const isLastTop = topIdx === topLevelCount - 1;
+        const topComma = isLastTop ? "" : ",";
+        const fragment = loadFragment(domain);
+        const fields = domainFields(props[domain], fragment);
+        out.push(`  "${domain}": {`);
+        const lines = fields.map(([field, def], idx) => {
+            const isLastField = idx === fields.length - 1;
+            const comma = isLastField ? "" : ",";
+            const info = classifyField(def);
+            const comment = commentFor(`${domain}.${field}`, info);
+            return { content: `    "${field}": ${PLACEHOLDER[info.kind]}${comma}`, comment };
+        });
+        out.push(...renderBlock(lines));
+        out.push(`  }${topComma}`);
+        topIdx++;
+    }
+    out.push("}");
+    return out.join("\n");
+}
+//# sourceMappingURL=generate-field-block.js.map

package/dist/extractors/generate-field-block.js.map

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

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

@@ -5,11 +5,11 @@
  */
 import OpenAI from "openai";
 import type { ExtractionInput, EdmProfile } from "../schema/types.js";
-import { type LlmExtractionResult } from "./llm-extractor.js";
+import { type ExtractorCallOptions, 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>;
+export declare function extractWithKimi(client: OpenAI, input: ExtractionInput, model?: string, profile?: EdmProfile, options?: ExtractorCallOptions): Promise<LlmExtractionResult>;
 /**
  * Create a Kimi client using MoonshotAI's direct API
  * Falls back to OpenRouter if direct API key is not available

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

@@ -1 +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;AAkC5B;;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,CAmF9B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA2BxD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAMvC"}
+{"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,EAIL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAsC5B;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,eAAe,EACtB,KAAK,GAAE,MAA2B,EAClC,OAAO,GAAE,UAAmB,EAC5B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAwF9B;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

@@ -5,7 +5,8 @@
  */
 import OpenAI from "openai";
 import { LlmExtractedFieldsSchema, LlmEssentialFieldsSchema, LlmExtendedFieldsSchema } from "../schema/edm-schema.js";
-import { EXTRACTION_SYSTEM_PROMPT, } from "./llm-extractor.js";
+import { EXTRACTION_SYSTEM_PROMPT, defaultMaxTokens, prepareInputText, } from "./llm-extractor.js";
+import { sanitizeLlmOutput } from "./output-sanitizer.js";
 /**
  * Get the appropriate schema for profile-specific validation
  */
@@ -22,10 +23,13 @@ function getProfileSchema(profile) {
 }
 import { getProfilePrompt, calculateProfileConfidence } from "./profile-prompts.js";
 /**
- * Default Kimi K2 model identifier
- * MoonshotAI exposes this via their OpenAI-compatible endpoint
+ * Default Kimi model identifier
+ * MoonshotAI exposes this via their OpenAI-compatible endpoint.
+ * kimi-k2-0711-preview was retired by Moonshot (404s as of 2026-06).
+ * Note: kimi-k2.5 is a thinking model — defaultMaxTokens() sizes the
+ * output budget accordingly.
  */
-const DEFAULT_KIMI_MODEL = "kimi-k2-0711-preview";
+const DEFAULT_KIMI_MODEL = "kimi-k2.5";
 /**
  * Kimi API base URLs
  * - Direct: api.moonshot.cn or api.moonshot.ai (requires MOONSHOT_API_KEY or KIMI_API_KEY)
@@ -38,13 +42,14 @@ 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") {
+export async function extractWithKimi(client, input, model = DEFAULT_KIMI_MODEL, profile = "full", options = {}) {
     const userContent = [];
-    // Add text content
-    if (input.text) {
+    // Add text content (conversation inputs get source-material framing)
+    const text = prepareInputText(input);
+    if (text) {
         userContent.push({
             type: "text",
-            text: input.text,
+            text,
         });
     }
     // Add image if provided (OpenAI-compatible format)
@@ -62,7 +67,7 @@ export async function extractWithKimi(client, input, model = DEFAULT_KIMI_MODEL,
     const systemPrompt = profilePrompt || EXTRACTION_SYSTEM_PROMPT;
     const response = await client.chat.completions.create({
         model,
-        max_tokens: 4096,
+        max_tokens: options.maxTokens ?? defaultMaxTokens(model),
         messages: [
             {
                 role: "system",
@@ -75,12 +80,12 @@ export async function extractWithKimi(client, input, model = DEFAULT_KIMI_MODEL,
         ],
     });
     // Extract text response
-    const text = response.choices[0]?.message?.content;
-    if (!text) {
+    const responseText = response.choices[0]?.message?.content;
+    if (!responseText) {
         throw new Error("No text response from Kimi K2");
     }
     // Parse JSON response (strip markdown code fences if present)
-    let jsonText = text.trim();
+    let jsonText = responseText.trim();
     const fenceMatch = jsonText.match(/^```(?:json)?\s*\n?([\s\S]*?)\n?\s*```$/);
     if (fenceMatch?.[1]) {
         jsonText = fenceMatch[1].trim();
@@ -90,8 +95,11 @@ export async function extractWithKimi(client, input, model = DEFAULT_KIMI_MODEL,
         parsed = JSON.parse(jsonText);
     }
     catch {
-        throw new Error(`Failed to parse Kimi response as JSON: ${text.slice(0, 200)}...`);
+        throw new Error(`Failed to parse Kimi response as JSON: ${responseText.slice(0, 200)}...`);
     }
+    // Sanitize before validation: clamp array caps, coerce invalid
+    // strict-enum values to null (prefer a null field over a dropped artifact)
+    sanitizeLlmOutput(parsed);
     // Validate against profile-specific schema
     const schema = getProfileSchema(profile);
     const result = schema.safeParse(parsed);

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

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

@@ -5,11 +5,29 @@
  */
 import Anthropic from "@anthropic-ai/sdk";
 import type { LlmExtractedFields, ExtractionInput, EdmProfile } from "../schema/types.js";
+/**
+ * Per-extractor call options.
+ */
+export interface ExtractorCallOptions {
+    /** Output token budget; defaults via defaultMaxTokens(model) */
+    maxTokens?: number;
+}
+/** Default output budget for non-thinking models */
+export declare const DEFAULT_MAX_TOKENS = 4096;
+/**
+ * Default output budget for thinking models, whose reasoning tokens count
+ * against max_tokens. 4096 silently truncated extraction JSON on exactly
+ * the most emotionally dense inputs (archive-sample run, 2026-06-10).
+ */
+export declare const THINKING_MODEL_MAX_TOKENS = 16384;
+export declare function defaultMaxTokens(model: string): number;
+/** Apply conversation framing when the input declares transcript content */
+export declare function prepareInputText(input: ExtractionInput): string | undefined;
 /**
  * System prompt for EDM extraction
  * See CHANGELOG.md for version-specific schema changes
  */
-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 have CANONICAL values \u2014 preferred values for cross-artifact comparability.\n- Use canonical values where they fit. If no canonical value accurately represents the content, use the most accurate free-text term. Accuracy takes precedence over canonical conformance.\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- emotion_primary, narrative_arc, relational_dynamics, and arc_type accept free text if no canonical value fits.\n- arc_type canonical values use underscores not spaces. Use moral_awakening not moral awakening. Canonical values must match exactly as listed \u2014 no spaces, no variations.\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. REQUIRED: include ALL of the following \u2014 \u22651 concrete sensory detail (sight, sound, smell, texture), \u22651 temporal cue that anchors the memory in time, \u22651 symbolic callback that connects past to present. Write from the subject's perspective. Do not compress or summarise \u2014 give the memory space to breathe. Faithful and specific. Never generic.\n  },\n  \"constellation\": {\n    \"emotion_primary\": \"\",           // CANONICAL: joy | sadness | fear | anger | wonder | peace | tenderness | reverence | pride | anxiety | gratitude | longing | hope | shame | disappointment | relief | frustration (free text accepted if none fits)\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\": \"\",             // CANONICAL: overcoming | transformation | connection | reflection | closure | loss | confrontation (free text accepted if none fits)\n    \"relational_dynamics\": \"\",       // CANONICAL: parent_child | grandparent_grandchild | romantic_partnership | couple | sibling_bond | family | friendship | friend | companionship | colleague | mentorship | reunion | community_ritual | grief | self_reflection | professional | therapeutic | service | adversarial (free text accepted if none fits)\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 | orphan | 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    \"arc_type\": \"\"                   // CANONICAL: betrayal | liberation | grief | discovery | resistance | bond | moral_awakening | transformation | reconciliation | reckoning | threshold | exile | gratitude | authenticity (free text accepted if none fits). gratitude = moments of thankfulness, appreciation, acknowledging blessing; authenticity = feeling fully oneself, self-alignment, identity congruence\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). Calibration: 0.9+ life-altering irreversible moments; 0.7-0.9 significant personal events with strong emotional response; 0.4-0.7 meaningful but routine emotional experiences; 0.1-0.4 mild passing emotional content\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    \"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 14 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 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\nSUBJECT ANCHORING (critical)\n- The SUBJECT is the person this artifact will belong to. In a chat transcript the SUBJECT is the USER speaker; ASSISTANT text is context only, never a source of the subject's experience.\n- Score every field relative to the SUBJECT, not the passage. emotional_weight measures what this content meant TO THE SUBJECT \u2014 not how vivid, dramatic, or emotionally rich the text itself is.\n- Routine work content (debugging, drafting, planning, logistics) is 0.1\u20130.4 even when the subject expresses momentary relief or frustration. Reserve 0.7+ for events with personal stakes the subject states or plainly carries. Do not invent somatic or emotional detail the subject never expressed.\n- transformational_pivot is true ONLY if the subject explicitly marks the experience as life-changing. Finishing a task, fixing a bug, or shipping a feature is not a transformational pivot.\n\nEXPERIENTIAL STANCE (critical)\nClassify whose experience the emotionally salient material is, in the top-level \"experiential_stance\" key:\n- \"lived\" \u2014 the subject's own first-hand experience\n- \"witnessed\" \u2014 events the subject personally witnessed or is directly affected by (a loved one's death, a family crisis)\n- \"quoted_third_party\" \u2014 someone else's story the subject quoted, pasted, or retold without being a participant (an article, test data, a stranger's anecdote)\n- \"assistant_generated\" \u2014 fiction, examples, or anecdotes produced by the assistant, not reported by the subject\n- \"hypothetical\" \u2014 imagined scenarios, drafts about invented people, role-play\nIf the stance is quoted_third_party, assistant_generated, or hypothetical: do NOT encode that material into wound, identity_thread, expressed_insight, somatic_signature, transformational_pivot, the impulse domain, or high emotional_weight \u2014 those fields describe the SUBJECT. Extract only what the content reveals about the subject themselves (e.g. why they engaged with it), or return null fields with low weight.\n\nCRITICAL: Enum Field Constraints\n- Many fields below have CANONICAL values \u2014 preferred values for cross-artifact comparability.\n- Use canonical values where they fit. If no canonical value accurately represents the content, use the most accurate free-text term. Accuracy takes precedence over canonical conformance.\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- emotion_primary, narrative_arc, relational_dynamics, and arc_type accept free text if no canonical value fits.\n- arc_type canonical values use underscores not spaces. Use moral_awakening not moral awakening. Canonical values must match exactly as listed \u2014 no spaces, no variations.\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  \"experiential_stance\": \"\", // STRICT ENUM: lived | witnessed | quoted_third_party | assistant_generated | hypothetical (pick ONE or null)\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. REQUIRED: include ALL of the following \u2014 \u22651 concrete sensory detail (sight, sound, smell, texture), \u22651 temporal cue that anchors the memory in time, \u22651 symbolic callback that connects past to present. Write from the subject's perspective. Do not compress or summarise \u2014 give the memory space to breathe. Faithful and specific. Never generic.\n  },\n  \"constellation\": {\n    \"emotion_primary\": \"\",           // CANONICAL: joy | sadness | fear | anger | wonder | peace | tenderness | reverence | pride | anxiety | gratitude | longing | hope | shame | disappointment | relief | frustration (free text accepted if none fits)\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\": \"\",             // CANONICAL: overcoming | transformation | connection | reflection | closure | loss | confrontation (free text accepted if none fits)\n    \"relational_dynamics\": \"\",       // CANONICAL: parent_child | grandparent_grandchild | romantic_partnership | couple | sibling_bond | family | friendship | friend | companionship | colleague | mentorship | reunion | community_ritual | grief | self_reflection | professional | therapeutic | service | adversarial (free text accepted if none fits)\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\": \"\",              // STRICT ENUM: photo | video | audio | text | photo_with_story (pick ONE or null)\n    \"narrative_archetype\": \"\",       // STRICT ENUM: hero | caregiver | seeker | sage | lover | outlaw | innocent | magician | creator | everyman | jester | ruler (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    \"arc_type\": \"\"                   // CANONICAL: betrayal | liberation | grief | discovery | resistance | bond | moral_awakening | transformation | reconciliation | reckoning | threshold | exile | gratitude | authenticity (free text accepted if none fits). gratitude = moments of thankfulness, appreciation, acknowledging blessing; authenticity = feeling fully oneself, self-alignment, identity congruence\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). Calibration: 0.9+ life-altering irreversible moments; 0.7-0.9 significant personal events with strong emotional response; 0.4-0.7 meaningful but routine emotional experiences; 0.1-0.4 mild passing emotional content\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\": \"\",          // CANONICAL: person | symbol | event | place | ritual | object | tradition | identity | self (free text accepted if none fits)\n    \"recall_triggers\": [],      // sensory or symbolic cues (lowercase tokens)\n    \"retrieval_keys\": [],       // compact hooks (3\u20136 tokens recommended)\n    \"nearby_themes\": [],        // adjacent concepts\n    \"recurrence_pattern\": \"\",   // CANONICAL: cyclical | isolated | chronic | emerging (free text accepted if none fits)\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 | authenticity (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\": \"\"              // CANONICAL: reframe_meaning | seek_support | distract | ritualize | confront | detach | process (free text accepted if none fits)\n  }\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 (two-tier free text) vs higher_order_emotion (free text):\n  //   - emotion_primary: prefer a canonical value when one fits; otherwise use the most accurate\n  //     free-text term (accuracy takes precedence over canonical conformance)\n  //   - Use higher_order_emotion for complex/second-order emotions layered on the primary feeling\n  //\n  // narrative_arc (story trajectory):\n  //   - Describes the STORY TRAJECTORY (overcoming, transformation, connection, reflection, closure, loss, confrontation)\n  //   - \"confrontation\" IS a canonical narrative_arc value (a confronting trajectory); free text accepted if none fits\n  //   - Distinct from the impulse-domain \"confront\" (drive_state / coping_style), which describes action/coping, not story shape\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";
 /**
  * Profile-specific extracted fields types
  */
@@ -20,6 +38,8 @@ export interface LlmEssentialExtracted {
         emotion_subtone: string[];
         narrative_arc: string | null;
     };
+    /** Present until the attribution guard consumes it (see stance-guard) */
+    experiential_stance?: string | null;
 }
 export interface LlmExtendedExtracted {
     core: LlmExtractedFields["core"];
@@ -32,6 +52,8 @@ export interface LlmExtendedExtracted {
         recurrence_pattern: string | null;
         strength_score: number;
     };
+    /** Present until the attribution guard consumes it (see stance-guard) */
+    experiential_stance?: string | null;
 }
 export interface LlmExtractionResult {
     extracted: LlmExtractedFields | LlmEssentialExtracted | LlmExtendedExtracted;
@@ -48,7 +70,7 @@ export interface LlmExtractionResult {
  * @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>;
+export declare function extractWithLlm(client: Anthropic, input: ExtractionInput, model?: string, profile?: EdmProfile, options?: ExtractorCallOptions): Promise<LlmExtractionResult>;
 /**
  * Calculate extraction confidence based on field population
  */

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

@@ -1 +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;AAQ1F;;;GAGG;AACH,eAAO,MAAM,wBAAwB,01bA2JpC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,EAAE;QACb,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACnD,SAAS,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,EAAE;QACP,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CAEH;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,kBAAkB,GAAG,qBAAqB,GAAG,oBAAoB,CAAC;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAiBD;;;;;;;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,CAiF9B;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"}
+{"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;AAU1F;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAKhD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAG3E;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,4xfAyKpC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,EAAE;QACb,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACnD,SAAS,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,EAAE;QACP,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IAEF,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,kBAAkB,GAAG,qBAAqB,GAAG,oBAAoB,CAAC;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAiBD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,eAAe,EACtB,KAAK,GAAE,MAAmC,EAC1C,OAAO,GAAE,UAAmB,EAC5B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAsF9B;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"}