@anuma/sdk 4.1.0 → 4.2.0

package/dist/server/index.cjs

@@ -29893,21 +29893,63 @@ var DEFAULT_PROFILE_FACETS = [
     guidance: "Summarize what the person has been up to lately in one line, favoring the most recently reinforced facts. Frame it as current/ongoing (e.g. 'Lately: training for a first half-marathon and learning Portuguese'). Omit if nothing recent stands out."
   }
 ];
+var NEARBY_MAX_OCCUPATION_CODEPOINTS = 80;
+var NEARBY_MAX_INTERESTS = 12;
+var NEARBY_MAX_INTEREST_CODEPOINTS = 40;
+var MAX_RAW_INTERESTS = NEARBY_MAX_INTERESTS * 2;
+function codePointLength(value) {
+  return [...value].length;
+}
+var FACET_BASE_PROPERTIES = {
+  summary: {
+    type: "string",
+    description: "The synthesized section prose. Empty string if the memories don't cover it."
+  },
+  hasEvidence: {
+    type: "boolean",
+    description: "False when the supplied memories don't support any claim for this facet."
+  }
+};
 var FACET_RESPONSE_SCHEMA = {
+  type: "object",
+  properties: FACET_BASE_PROPERTIES,
+  required: ["summary", "hasEvidence"],
+  additionalProperties: false
+};
+var WORK_ROLE_RESPONSE_SCHEMA = {
   type: "object",
   properties: {
-    summary: {
+    ...FACET_BASE_PROPERTIES,
+    occupation: {
       type: "string",
-      description: "The synthesized section prose. Empty string if the memories don't cover it."
-    },
-    hasEvidence: {
-      type: "boolean",
-      description: "False when the supplied memories don't support any claim for this facet."
+      description: `The same role as a standalone phrase for a profile field, at most ${NEARBY_MAX_OCCUPATION_CODEPOINTS} characters (e.g. "Backend engineer, fintech"). Empty string when hasEvidence is false.`
     }
   },
-  required: ["summary", "hasEvidence"],
+  required: ["summary", "hasEvidence", "occupation"],
+  additionalProperties: false
+};
+var INTERESTS_RESPONSE_SCHEMA = {
+  type: "object",
+  properties: {
+    ...FACET_BASE_PROPERTIES,
+    interests: {
+      type: "array",
+      items: { type: "string" },
+      description: `The same interests as discrete strings \u2014 at most ${NEARBY_MAX_INTERESTS} items, each at most ${NEARBY_MAX_INTEREST_CODEPOINTS} characters (e.g. ["trail running", "film photography"]). Empty array when hasEvidence is false.`
+    }
+  },
+  required: ["summary", "hasEvidence", "interests"],
   additionalProperties: false
 };
+function facetResponseSchema(key) {
+  if (key === "work_role") return WORK_ROLE_RESPONSE_SCHEMA;
+  if (key === "interests") return INTERESTS_RESPONSE_SCHEMA;
+  return FACET_RESPONSE_SCHEMA;
+}
+var FACET_STRUCTURED_RESPONSE_HINT = {
+  work_role: `, "occupation": <the role as a standalone phrase of at most ${NEARBY_MAX_OCCUPATION_CODEPOINTS} characters, e.g. "Backend engineer, fintech", or "">`,
+  interests: `, "interests": <the same interests as an array of at most ${NEARBY_MAX_INTERESTS} strings of at most ${NEARBY_MAX_INTEREST_CODEPOINTS} characters each, e.g. ["trail running", "film photography"], or []>`
+};
 async function synthesizeProfile(ctx, options = {}) {
   if (!ctx.vaultCtx) {
     throw new Error("synthesizeProfile requires ctx.vaultCtx (vault-backed facts).");
@@ -30003,7 +30045,7 @@ function reviewedMemoryIdsSignature(ids) {
   return [...new Set(ids)].sort().join("\n");
 }
 function facetsSignature(facets) {
-  return facets.map((f) => JSON.stringify([f.key, f.label, f.query, f.guidance])).sort().join("\n");
+  return facets.map((f) => JSON.stringify([f.key, f.label, f.query, f.guidance, facetResponseSchema(f.key)])).sort().join("\n");
 }
 function trendsEqual(a, b) {
   if (!a) return false;
@@ -30151,7 +30193,7 @@ async function synthesizeFacet(facet, ctx, options, prior) {
     types: ["fact"],
     maxTokens: DEFAULT_FACET_MAX_TOKENS,
     systemPrompt: buildFacetSystemPrompt(facet),
-    responseSchema: FACET_RESPONSE_SCHEMA,
+    responseSchema: facetResponseSchema(facet.key),
     memories
   });
   const noEvidence = result.basedOn.memoryIds.length === 0;
@@ -30174,6 +30216,25 @@ async function synthesizeFacet(facet, ctx, options, prior) {
     const redacted = await options.redactor.redactTextAsync(text12);
     section.text = redacted.text;
   }
+  if (!legitimateEmpty && !noEvidence) {
+    const values = extractStructuredValues(facet.key, result.structuredOutput);
+    if (options.redactor) {
+      if (values.occupation) {
+        values.occupation = (await options.redactor.redactTextAsync(values.occupation)).text;
+      }
+      if (values.interests) {
+        const gated = [];
+        for (const interest of values.interests) {
+          gated.push((await options.redactor.redactTextAsync(interest)).text);
+        }
+        values.interests = gated;
+      }
+    }
+    const occupation = normalizeOccupation(values.occupation);
+    if (occupation !== void 0) section.occupation = occupation;
+    const interests = normalizeInterests(values.interests);
+    if (interests !== void 0) section.interests = interests;
+  }
   return section;
 }
 function fallbackSection(facet, prior) {
@@ -30190,6 +30251,7 @@ function fallbackSection(facet, prior) {
   };
 }
 function buildFacetSystemPrompt(facet) {
+  const structuredField = FACET_STRUCTURED_RESPONSE_HINT[facet.key] ?? "";
   return `You are writing the "${facet.label}" section of a person's shareable profile, using their private memories (supplied as evidence) as the only source of truth.
 
 Task for this section:
@@ -30200,7 +30262,7 @@ Rules:
 - If the memories don't cover this section, return an empty summary with hasEvidence=false. Do not pad or guess.
 - Write in third person about the person, in a natural voice suitable for a public profile (no "I"/"you", no name repetition).
 - Be concise and specific; no preamble, hedging, or meta-commentary.
-- Respond as JSON: { "summary": <the section text, or "">, "hasEvidence": <true|false> }.`;
+- Respond as JSON: { "summary": <the section text, or "">, "hasEvidence": <true|false>${structuredField} }.`;
 }
 function extractFacetText(structured) {
   if (structured && typeof structured === "object") {
@@ -30211,6 +30273,73 @@ function extractFacetText(structured) {
   }
   return { text: "", legitimateEmpty: false };
 }
+function extractStructuredValues(key, structured) {
+  if (!structured || typeof structured !== "object") return {};
+  const obj = structured;
+  if (key === "work_role") {
+    return typeof obj.occupation === "string" ? { occupation: obj.occupation } : {};
+  }
+  if (key === "interests") {
+    const list = coerceInterestList(obj.interests);
+    if (list) return { interests: list.slice(0, MAX_RAW_INTERESTS) };
+  }
+  return {};
+}
+function coerceInterestList(value) {
+  if (Array.isArray(value)) return value.filter((i) => typeof i === "string");
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  if (trimmed.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (Array.isArray(parsed)) return parsed.filter((i) => typeof i === "string");
+    } catch {
+      if (trimmed.endsWith("]")) return splitInterestFragments(trimmed.slice(1, -1));
+    }
+  }
+  return splitInterestFragments(trimmed);
+}
+function splitInterestFragments(source) {
+  return source.split(",").map((fragment) => {
+    let entry = fragment.trim();
+    if (entry.startsWith("[")) entry = entry.slice(1);
+    if (entry.endsWith("]")) entry = entry.slice(0, -1);
+    entry = entry.trim();
+    const quote = entry[0];
+    if ((quote === '"' || quote === "'") && entry.endsWith(quote)) entry = entry.slice(1, -1);
+    return entry;
+  });
+}
+function normalizeOccupation(value) {
+  if (value === void 0) return void 0;
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  const length = codePointLength(trimmed);
+  if (length > NEARBY_MAX_OCCUPATION_CODEPOINTS) {
+    getLogger().warn(
+      "[memory/synthesizeProfile] occupation exceeded the publishable length; dropping it",
+      { length, max: NEARBY_MAX_OCCUPATION_CODEPOINTS }
+    );
+    return void 0;
+  }
+  return trimmed;
+}
+function normalizeInterests(values) {
+  if (values === void 0) return void 0;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const value of values) {
+    const trimmed = value.trim();
+    if (!trimmed) continue;
+    if (codePointLength(trimmed) > NEARBY_MAX_INTEREST_CODEPOINTS) continue;
+    const key = trimmed.toLowerCase();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(trimmed);
+    if (out.length === NEARBY_MAX_INTERESTS) break;
+  }
+  return out.length > 0 ? out : void 0;
+}
 
 // src/lib/memory/topicExtract.ts
 init_operations2();

package/dist/server/index.d.mts

@@ -8277,6 +8277,23 @@ interface ProfileSection {
     text: string;
     /** Vault memory ids this section was grounded on — provenance + delta refresh. */
     sourceMemoryIds: string[];
+    /**
+     * Structured occupation — the `work_role` facet only. A short role phrase
+     * (at most 80 code points, PII-gated alongside {@link ProfileSection.text})
+     * that a profile store's `occupation` column takes verbatim.
+     *
+     * Absent when the facet found no evidence, when the model didn't return one,
+     * or when the value it returned couldn't be made publishable. `text` is
+     * unaffected either way, so the prose is never blocked on this.
+     */
+    occupation?: string;
+    /**
+     * Structured interests — the `interests` facet only. Discrete entries,
+     * trimmed and deduped case- and space-insensitively (first spelling wins), at
+     * most 12 items of at most 40 code points each, ready for a profile store's
+     * `interests` column. Absent when nothing survived normalization.
+     */
+    interests?: string[];
     /** Unix ms this section was generated. */
     generatedAt: number;
     /** True when regeneration failed and a prior section value was carried
@@ -8293,10 +8310,12 @@ interface ProfileConfigFingerprint {
     /** Facet keys present in the doc, sorted. */
     facetKeys: ProfileFacetKey[];
     /** Order-independent digest of each facet's full definition (key + label +
-     * query + guidance). Reuse must invalidate when a facet's PROMPT changes, not
-     * just its key set — otherwise reused sections carry text generated under the
-     * old definition. Facet display order does NOT invalidate (sections are
-     * rebuilt in facet order and reused by key). */
+     * query + guidance) and the response schema it is synthesized under. Reuse
+     * must invalidate when a facet's PROMPT changes, not just its key set —
+     * otherwise reused sections carry text generated under the old definition,
+     * or under an output schema that predates a field the caller now reads.
+     * Facet display order does NOT invalidate (sections are rebuilt in facet
+     * order and reused by key). */
     facetsSignature: string;
     /** Scopes the facts were drawn from, sorted. */
     scopes: string[];

package/dist/server/index.d.ts

@@ -8277,6 +8277,23 @@ interface ProfileSection {
     text: string;
     /** Vault memory ids this section was grounded on — provenance + delta refresh. */
     sourceMemoryIds: string[];
+    /**
+     * Structured occupation — the `work_role` facet only. A short role phrase
+     * (at most 80 code points, PII-gated alongside {@link ProfileSection.text})
+     * that a profile store's `occupation` column takes verbatim.
+     *
+     * Absent when the facet found no evidence, when the model didn't return one,
+     * or when the value it returned couldn't be made publishable. `text` is
+     * unaffected either way, so the prose is never blocked on this.
+     */
+    occupation?: string;
+    /**
+     * Structured interests — the `interests` facet only. Discrete entries,
+     * trimmed and deduped case- and space-insensitively (first spelling wins), at
+     * most 12 items of at most 40 code points each, ready for a profile store's
+     * `interests` column. Absent when nothing survived normalization.
+     */
+    interests?: string[];
     /** Unix ms this section was generated. */
     generatedAt: number;
     /** True when regeneration failed and a prior section value was carried
@@ -8293,10 +8310,12 @@ interface ProfileConfigFingerprint {
     /** Facet keys present in the doc, sorted. */
     facetKeys: ProfileFacetKey[];
     /** Order-independent digest of each facet's full definition (key + label +
-     * query + guidance). Reuse must invalidate when a facet's PROMPT changes, not
-     * just its key set — otherwise reused sections carry text generated under the
-     * old definition. Facet display order does NOT invalidate (sections are
-     * rebuilt in facet order and reused by key). */
+     * query + guidance) and the response schema it is synthesized under. Reuse
+     * must invalidate when a facet's PROMPT changes, not just its key set —
+     * otherwise reused sections carry text generated under the old definition,
+     * or under an output schema that predates a field the caller now reads.
+     * Facet display order does NOT invalidate (sections are rebuilt in facet
+     * order and reused by key). */
     facetsSignature: string;
     /** Scopes the facts were drawn from, sorted. */
     scopes: string[];

package/dist/server/index.mjs

@@ -6886,21 +6886,63 @@ var DEFAULT_PROFILE_FACETS = [
     guidance: "Summarize what the person has been up to lately in one line, favoring the most recently reinforced facts. Frame it as current/ongoing (e.g. 'Lately: training for a first half-marathon and learning Portuguese'). Omit if nothing recent stands out."
   }
 ];
+var NEARBY_MAX_OCCUPATION_CODEPOINTS = 80;
+var NEARBY_MAX_INTERESTS = 12;
+var NEARBY_MAX_INTEREST_CODEPOINTS = 40;
+var MAX_RAW_INTERESTS = NEARBY_MAX_INTERESTS * 2;
+function codePointLength(value) {
+  return [...value].length;
+}
+var FACET_BASE_PROPERTIES = {
+  summary: {
+    type: "string",
+    description: "The synthesized section prose. Empty string if the memories don't cover it."
+  },
+  hasEvidence: {
+    type: "boolean",
+    description: "False when the supplied memories don't support any claim for this facet."
+  }
+};
 var FACET_RESPONSE_SCHEMA = {
+  type: "object",
+  properties: FACET_BASE_PROPERTIES,
+  required: ["summary", "hasEvidence"],
+  additionalProperties: false
+};
+var WORK_ROLE_RESPONSE_SCHEMA = {
   type: "object",
   properties: {
-    summary: {
+    ...FACET_BASE_PROPERTIES,
+    occupation: {
       type: "string",
-      description: "The synthesized section prose. Empty string if the memories don't cover it."
-    },
-    hasEvidence: {
-      type: "boolean",
-      description: "False when the supplied memories don't support any claim for this facet."
+      description: `The same role as a standalone phrase for a profile field, at most ${NEARBY_MAX_OCCUPATION_CODEPOINTS} characters (e.g. "Backend engineer, fintech"). Empty string when hasEvidence is false.`
     }
   },
-  required: ["summary", "hasEvidence"],
+  required: ["summary", "hasEvidence", "occupation"],
+  additionalProperties: false
+};
+var INTERESTS_RESPONSE_SCHEMA = {
+  type: "object",
+  properties: {
+    ...FACET_BASE_PROPERTIES,
+    interests: {
+      type: "array",
+      items: { type: "string" },
+      description: `The same interests as discrete strings \u2014 at most ${NEARBY_MAX_INTERESTS} items, each at most ${NEARBY_MAX_INTEREST_CODEPOINTS} characters (e.g. ["trail running", "film photography"]). Empty array when hasEvidence is false.`
+    }
+  },
+  required: ["summary", "hasEvidence", "interests"],
   additionalProperties: false
 };
+function facetResponseSchema(key) {
+  if (key === "work_role") return WORK_ROLE_RESPONSE_SCHEMA;
+  if (key === "interests") return INTERESTS_RESPONSE_SCHEMA;
+  return FACET_RESPONSE_SCHEMA;
+}
+var FACET_STRUCTURED_RESPONSE_HINT = {
+  work_role: `, "occupation": <the role as a standalone phrase of at most ${NEARBY_MAX_OCCUPATION_CODEPOINTS} characters, e.g. "Backend engineer, fintech", or "">`,
+  interests: `, "interests": <the same interests as an array of at most ${NEARBY_MAX_INTERESTS} strings of at most ${NEARBY_MAX_INTEREST_CODEPOINTS} characters each, e.g. ["trail running", "film photography"], or []>`
+};
 async function synthesizeProfile(ctx, options = {}) {
   if (!ctx.vaultCtx) {
     throw new Error("synthesizeProfile requires ctx.vaultCtx (vault-backed facts).");
@@ -6996,7 +7038,7 @@ function reviewedMemoryIdsSignature(ids) {
   return [...new Set(ids)].sort().join("\n");
 }
 function facetsSignature(facets) {
-  return facets.map((f) => JSON.stringify([f.key, f.label, f.query, f.guidance])).sort().join("\n");
+  return facets.map((f) => JSON.stringify([f.key, f.label, f.query, f.guidance, facetResponseSchema(f.key)])).sort().join("\n");
 }
 function trendsEqual(a, b) {
   if (!a) return false;
@@ -7144,7 +7186,7 @@ async function synthesizeFacet(facet, ctx, options, prior) {
     types: ["fact"],
     maxTokens: DEFAULT_FACET_MAX_TOKENS,
     systemPrompt: buildFacetSystemPrompt(facet),
-    responseSchema: FACET_RESPONSE_SCHEMA,
+    responseSchema: facetResponseSchema(facet.key),
     memories
   });
   const noEvidence = result.basedOn.memoryIds.length === 0;
@@ -7167,6 +7209,25 @@ async function synthesizeFacet(facet, ctx, options, prior) {
     const redacted = await options.redactor.redactTextAsync(text12);
     section.text = redacted.text;
   }
+  if (!legitimateEmpty && !noEvidence) {
+    const values = extractStructuredValues(facet.key, result.structuredOutput);
+    if (options.redactor) {
+      if (values.occupation) {
+        values.occupation = (await options.redactor.redactTextAsync(values.occupation)).text;
+      }
+      if (values.interests) {
+        const gated = [];
+        for (const interest of values.interests) {
+          gated.push((await options.redactor.redactTextAsync(interest)).text);
+        }
+        values.interests = gated;
+      }
+    }
+    const occupation = normalizeOccupation(values.occupation);
+    if (occupation !== void 0) section.occupation = occupation;
+    const interests = normalizeInterests(values.interests);
+    if (interests !== void 0) section.interests = interests;
+  }
   return section;
 }
 function fallbackSection(facet, prior) {
@@ -7183,6 +7244,7 @@ function fallbackSection(facet, prior) {
   };
 }
 function buildFacetSystemPrompt(facet) {
+  const structuredField = FACET_STRUCTURED_RESPONSE_HINT[facet.key] ?? "";
   return `You are writing the "${facet.label}" section of a person's shareable profile, using their private memories (supplied as evidence) as the only source of truth.
 
 Task for this section:
@@ -7193,7 +7255,7 @@ Rules:
 - If the memories don't cover this section, return an empty summary with hasEvidence=false. Do not pad or guess.
 - Write in third person about the person, in a natural voice suitable for a public profile (no "I"/"you", no name repetition).
 - Be concise and specific; no preamble, hedging, or meta-commentary.
-- Respond as JSON: { "summary": <the section text, or "">, "hasEvidence": <true|false> }.`;
+- Respond as JSON: { "summary": <the section text, or "">, "hasEvidence": <true|false>${structuredField} }.`;
 }
 function extractFacetText(structured) {
   if (structured && typeof structured === "object") {
@@ -7204,6 +7266,73 @@ function extractFacetText(structured) {
   }
   return { text: "", legitimateEmpty: false };
 }
+function extractStructuredValues(key, structured) {
+  if (!structured || typeof structured !== "object") return {};
+  const obj = structured;
+  if (key === "work_role") {
+    return typeof obj.occupation === "string" ? { occupation: obj.occupation } : {};
+  }
+  if (key === "interests") {
+    const list = coerceInterestList(obj.interests);
+    if (list) return { interests: list.slice(0, MAX_RAW_INTERESTS) };
+  }
+  return {};
+}
+function coerceInterestList(value) {
+  if (Array.isArray(value)) return value.filter((i) => typeof i === "string");
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  if (trimmed.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (Array.isArray(parsed)) return parsed.filter((i) => typeof i === "string");
+    } catch {
+      if (trimmed.endsWith("]")) return splitInterestFragments(trimmed.slice(1, -1));
+    }
+  }
+  return splitInterestFragments(trimmed);
+}
+function splitInterestFragments(source) {
+  return source.split(",").map((fragment) => {
+    let entry = fragment.trim();
+    if (entry.startsWith("[")) entry = entry.slice(1);
+    if (entry.endsWith("]")) entry = entry.slice(0, -1);
+    entry = entry.trim();
+    const quote = entry[0];
+    if ((quote === '"' || quote === "'") && entry.endsWith(quote)) entry = entry.slice(1, -1);
+    return entry;
+  });
+}
+function normalizeOccupation(value) {
+  if (value === void 0) return void 0;
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  const length = codePointLength(trimmed);
+  if (length > NEARBY_MAX_OCCUPATION_CODEPOINTS) {
+    getLogger().warn(
+      "[memory/synthesizeProfile] occupation exceeded the publishable length; dropping it",
+      { length, max: NEARBY_MAX_OCCUPATION_CODEPOINTS }
+    );
+    return void 0;
+  }
+  return trimmed;
+}
+function normalizeInterests(values) {
+  if (values === void 0) return void 0;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const value of values) {
+    const trimmed = value.trim();
+    if (!trimmed) continue;
+    if (codePointLength(trimmed) > NEARBY_MAX_INTEREST_CODEPOINTS) continue;
+    const key = trimmed.toLowerCase();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(trimmed);
+    if (out.length === NEARBY_MAX_INTERESTS) break;
+  }
+  return out.length > 0 ? out : void 0;
+}
 
 // src/lib/memory/topicExtract.ts
 var TOPIC_EXTRACTION_BATCH_SIZE = 10;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",