@anuma/sdk 6.11.0 → 6.12.1

package/dist/expo/index.mjs

@@ -132,7 +132,7 @@ import {
   upsertMessageOp,
   useEncryption,
   vaultMemoryToStored
-} from "./chunk-ZO7S3TBT.mjs";
+} from "./chunk-732ZLOLA.mjs";
 import {
   PII_PATTERNS,
   PiiRedactor,
@@ -8131,11 +8131,13 @@ Respond with ONLY a single JSON object conforming to this JSON Schema, with no p
 ${JSON.stringify(
     options.responseSchema
   )}` : basePrompt;
-  const userMessage = `Question:
-${trimmed}
-
-Memories (use only these as evidence):
-${evidence}`;
+  const userMessage = [
+    `Question:
+${trimmed}`,
+    ...options.userInstructions ? [options.userInstructions] : [],
+    `Memories (use only these as evidence):
+${evidence}`
+  ].join("\n\n");
   const maxTokens = options.maxTokens ?? DEFAULT_MAX_TOKENS;
   const fetchImpl = options.fetchFn ?? fetch;
   const log = getLogger();
@@ -8149,7 +8151,13 @@ ${evidence}`;
   try {
     response = await fetchImpl(`${baseUrl}/api/v1/chat/completions`, {
       method: "POST",
-      headers: { ...authHeaders, "Content-Type": "application/json" },
+      // No task type unless the caller named one — an undeclared task adds no
+      // header at all, which is what keeps user-facing reflect() unlabelled.
+      headers: {
+        ...authHeaders,
+        ...taskTypeHeader(options.taskType),
+        "Content-Type": "application/json"
+      },
       body: JSON.stringify({
         model,
         // Modern OpenAI field; the portal reads only `max_completion_tokens`
@@ -8589,10 +8597,15 @@ async function synthesizeFacet(facet, ctx, options, prior) {
     limit,
     types: ["fact"],
     maxTokens: DEFAULT_FACET_MAX_TOKENS,
-    // Profile-facet synthesis is a background op, so it marks its own prompt.
-    // reflect() itself must NOT mark — it also serves the user's own questions,
-    // and that traffic is chat, not an internal flow. See ../internalFlowMarker.
-    systemPrompt: withInternalFlowMarker(buildFacetSystemPrompt(facet)),
+    // Profile-facet synthesis is a background op, so it marks its own prompt AND
+    // names its own task. reflect() itself must do neither — it also serves the
+    // user's own questions, and that traffic is chat, not an internal flow. See
+    // ../internalFlowMarker and ReflectOptions.taskType.
+    taskType: "memory_profile_synth",
+    systemPrompt: withInternalFlowMarker(FACET_SYSTEM_PROMPT),
+    // The facet's label/guidance/response-fields, on the user turn — what keeps
+    // the system half fixed and therefore server-ownable.
+    userInstructions: buildFacetUserInstructions(facet),
     responseSchema: facetResponseSchema(facet.key),
     memories
   });
@@ -8650,19 +8663,22 @@ function fallbackSection(facet, prior) {
     stale: true
   };
 }
-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:
-${facet.guidance}
+var FACET_SYSTEM_PROMPT = `You are writing one section of a person's shareable profile, using their private memories (supplied as evidence) as the only source of truth. The user turn names the section, states the task for it, and gives the exact JSON shape to respond in.
 
 Rules:
 - Ground every claim in the supplied memories \u2014 never invent, infer beyond, or embellish what they support.
 - 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>${structuredField} }.`;
+- Respond as JSON in exactly the shape the user turn states, with no extra fields.`;
+function buildFacetUserInstructions(facet) {
+  const structuredField = FACET_STRUCTURED_RESPONSE_HINT[facet.key] ?? "";
+  return `Section: "${facet.label}"
+
+Task for this section:
+${facet.guidance}
+
+Respond as JSON: { "summary": <the section text, or "">, "hasEvidence": <true|false>${structuredField} }.`;
 }
 function extractFacetText(structured) {
   if (structured && typeof structured === "object") {
@@ -9946,6 +9962,20 @@ function clientToolToCompletionsFormat(tool) {
 }
 var TOOL_SEARCH_TOOL_TYPE = "tool_search_tool_regex_20251119";
 var TOOL_SEARCH_TOOL_NAME = "tool_search_tool_regex";
+function resolveDeferredServerTools(allServerTools, serverToolsFilter, config) {
+  const allowed = serverToolsFilter === void 0 || typeof serverToolsFilter === "function" ? allServerTools : filterServerTools(allServerTools, [...serverToolsFilter]);
+  const excluded = new Set(config.excludeTools ?? []);
+  if (typeof serverToolsFilter === "function") {
+    for (const name of serverToolsFilter.excludeTools ?? []) excluded.add(name);
+  }
+  if (excluded.size === 0) return allowed;
+  return allowed.filter((tool) => !excluded.has(tool.name));
+}
+function deferFormattingConfig(serverToolsFilter, config) {
+  if (!config?.enabled) return config;
+  const isExplicitList = serverToolsFilter !== void 0 && typeof serverToolsFilter !== "function";
+  return isExplicitList ? void 0 : config;
+}
 function byNameAscending(a, b) {
   if (a.name < b.name) return -1;
   if (a.name > b.name) return 1;
@@ -10272,7 +10302,7 @@ function createServerToolsFilter(options = {}) {
   const exclude = new Set(options.excludeTools ?? []);
   const sets = options.toolSets ?? [];
   const matchOpts = options.matchOptions;
-  return (embeddings, tools) => {
+  const filter = (embeddings, tools) => {
     const matches = findMatchingTools(embeddings, tools, matchOpts);
     if (matches.length === 0) return [];
     const matchedNames = new Set(matches.map((m) => m.tool.name));
@@ -10290,6 +10320,10 @@ function createServerToolsFilter(options = {}) {
     for (const name of exclude) finalNames.delete(name);
     return [...finalNames];
   };
+  return Object.defineProperty(filter, "excludeTools", {
+    value: Object.freeze([...exclude]),
+    enumerable: false
+  });
 }
 var DEFAULT_EXCLUDED_SERVER_TOOLS = [
   "AnumaVisionMCP-anuma_analyze_image",
@@ -11289,7 +11323,11 @@ function useChatStorage(options) {
               cache: serverToolsConfig?.cache
             });
             if (serverToolsConfig?.deferLoading?.enabled) {
-              filteredServerTools2 = allServerTools;
+              filteredServerTools2 = resolveDeferredServerTools(
+                allServerTools,
+                serverToolsFilter,
+                serverToolsConfig.deferLoading
+              );
             } else if (isServerToolsFunction2) {
               if (messageContent.length >= MIN_CONTENT_LENGTH_FOR_TOOLS) {
                 skipUserEmbedding = await embedToolText(
@@ -11348,7 +11386,7 @@ function useChatStorage(options) {
             filteredServerTools2,
             narrowedClientTools2,
             effectiveApiType2,
-            serverToolsConfig?.deferLoading
+            deferFormattingConfig(serverToolsFilter, serverToolsConfig?.deferLoading)
           );
         }
         if (onToolSelection) {
@@ -11561,7 +11599,11 @@ function useChatStorage(options) {
           if ("error" in settledTools) throw settledTools.error;
           const allServerTools = settledTools.tools;
           if (serverToolsConfig?.deferLoading?.enabled && effectiveApiType === "responses") {
-            filteredServerTools = allServerTools;
+            filteredServerTools = resolveDeferredServerTools(
+              allServerTools,
+              serverToolsFilter,
+              serverToolsConfig.deferLoading
+            );
           } else if (isServerToolsFunction) {
             if (contentForStorage.length >= MIN_CONTENT_LENGTH_FOR_TOOLS) {
               const settledEmbedding = await (userMessageEmbeddingPromise ?? embedForToolsSettled(getTokenRef.current));
@@ -11581,7 +11623,7 @@ function useChatStorage(options) {
               filteredServerTools,
               clientTools,
               effectiveApiType,
-              serverToolsConfig?.deferLoading
+              deferFormattingConfig(serverToolsFilter, serverToolsConfig?.deferLoading)
             );
           }
         } catch (error) {
@@ -11622,7 +11664,7 @@ function useChatStorage(options) {
             filteredServerTools,
             narrowedClientTools,
             effectiveApiType,
-            serverToolsConfig?.deferLoading
+            deferFormattingConfig(serverToolsFilter, serverToolsConfig?.deferLoading)
           ) : void 0;
         } catch (error) {
           getLogger().warn("[useChatStorage] client tool filtering failed:", error);

package/dist/expo/{recall-OALPGL3H.mjs → recall-PIATJ336.mjs}

@@ -1,6 +1,6 @@
 import {
   recall
-} from "./chunk-ZO7S3TBT.mjs";
+} from "./chunk-732ZLOLA.mjs";
 import "./chunk-CJ32HO6Q.mjs";
 import "./chunk-GYKJOWEO.mjs";
 export {

package/dist/index.cjs

@@ -2293,7 +2293,7 @@ function createServerToolsFilter(options = {}) {
   const exclude = new Set(options.excludeTools ?? []);
   const sets = options.toolSets ?? [];
   const matchOpts = options.matchOptions;
-  return (embeddings, tools) => {
+  const filter = (embeddings, tools) => {
     const matches = findMatchingTools(embeddings, tools, matchOpts);
     if (matches.length === 0) return [];
     const matchedNames = new Set(matches.map((m) => m.tool.name));
@@ -2311,6 +2311,10 @@ function createServerToolsFilter(options = {}) {
     for (const name of exclude) finalNames.delete(name);
     return [...finalNames];
   };
+  return Object.defineProperty(filter, "excludeTools", {
+    value: Object.freeze([...exclude]),
+    enumerable: false
+  });
 }
 var DEFAULT_EXCLUDED_SERVER_TOOLS = [
   "AnumaVisionMCP-anuma_analyze_image",

package/dist/index.d.mts

@@ -7900,7 +7900,7 @@ interface CreateServerToolsFilterOptions {
  * });
  * ```
  */
-declare function createServerToolsFilter(options?: CreateServerToolsFilterOptions): (embeddings: number[] | number[][], tools: ServerTool[]) => string[];
+declare function createServerToolsFilter(options?: CreateServerToolsFilterOptions): ServerToolsFilterFunction;
 /**
  * Default exclusions baked into `defaultServerToolsFilter`.
  *
@@ -7941,7 +7941,21 @@ declare const DEFAULT_SERVER_TOOLS_MATCH_OPTIONS: ToolMatchOptions;
  * If you need to customize (extra excludes, different limits, opt into
  * tool-set expansion), call `createServerToolsFilter` directly.
  */
-declare const defaultServerToolsFilter: (embeddings: number[] | number[][], tools: ServerTool[]) => string[];
+declare const defaultServerToolsFilter: ServerToolsFilterFunction;
+/**
+ * Type for a server-tools filter — a function that takes prompt embeddings
+ * and the full server tool catalog and returns the names of tools to keep.
+ * Matches `useChatStorage`'s `serverTools` callback signature.
+ */
+type ServerToolsFilterFunction = ((embeddings: number[] | number[][], tools: ServerTool[]) => string[]) & {
+    /**
+     * The unconditional exclusions this filter applies, exposed by
+     * {@link createServerToolsFilter} so defer-loading can honour them without the caller
+     * repeating the list — see {@link resolveDeferredServerTools}. Absent on a hand-written
+     * filter, or on one wrapped in a plain closure.
+     */
+    readonly excludeTools?: readonly string[];
+};
 /**
  * Options for selectServerSideTools
  */
@@ -8916,6 +8930,20 @@ declare function decryptConversationTitle(encryptedTitle: string, address: strin
  * `AllTaskTypes` on the portal side, and see ai-portal
  * `docs/BACKEND_OWNED_TASK_PROMPTS.md` for the rollout.
  *
+ * ⚠ RELEASE ORDER. This union is a PUBLIC type, so a split is breaking in both
+ * directions and has to be sequenced:
+ *
+ *   1. merge + publish this package;
+ *   2. bump `@anuma/sdk` in the consumer and switch its call sites to the new
+ *      names in the same commit.
+ *
+ * A consumer on the OLD version cannot compile the new names, and a consumer on
+ * the NEW version cannot compile the retired ones (`app_inspiration` is gone
+ * here, replaced by the three `app_inspiration_*` names). Both halves of that
+ * are type-only — the wire itself always degrades safely, because the portal
+ * drops any value it does not recognise. Concretely: ai-memoryless-client#5782
+ * is blocked on this publish for exactly that reason.
+ *
  * Deliberately ABSENT: agent personas, `reflect()` when it answers the user, and
  * the app-idea chat. Those carry an open conversation with the user, so a fixed
  * server-owned prompt would be wrong rather than merely premature — the same
@@ -8923,7 +8951,7 @@ declare function decryptConversationTitle(encryptedTitle: string, address: strin
  *
  * @public
  */
-type TaskType = "title" | "commit_message" | "memory_extract" | "memory_dedup" | "memory_decay" | "memory_injection_check" | "memory_verify_support" | "memory_autosort" | "memory_topic" | "memory_consolidate" | "memory_decompose" | "memory_profile_synth" | "memory_graph" | "folder_context" | "selection_memory" | "summarize" | "style_analysis" | "classify_search" | "app_inspiration" | "spotlight_image" | "slide_image" | "media_video" | "media_audio" | "media_bg_removal" | "media_image_preset" | "tool_app_builder" | "tool_document_builder" | "tool_slides" | "connector_guidance" | "cf_task" | "xbot_intent" | "xbot_council" | "scheduled_task";
+type TaskType = "title" | "commit_message" | "memory_extract" | "memory_dedup" | "memory_decay" | "memory_injection_check" | "memory_verify_support" | "memory_autosort" | "memory_topic" | "memory_consolidate" | "memory_decompose" | "memory_profile_synth" | "memory_graph" | "folder_context" | "selection_memory" | "summarize" | "style_analysis" | "classify_search" | "app_inspiration_generate" | "app_inspiration_trends" | "app_inspiration_remix" | "spotlight_image" | "slide_image" | "slide_video" | "slide_music" | "slide_sfx" | "media_video" | "media_audio" | "media_bg_removal" | "media_image_preset" | "tool_app_builder" | "tool_document_builder" | "tool_slides" | "tool_slides_image_gen" | "connector_guidance" | "cf_task" | "xbot_intent" | "xbot_council" | "scheduled_task";
 /**
  * HTTP header naming the Class-B task a request performs.
  *

package/dist/index.d.ts

@@ -7900,7 +7900,7 @@ interface CreateServerToolsFilterOptions {
  * });
  * ```
  */
-declare function createServerToolsFilter(options?: CreateServerToolsFilterOptions): (embeddings: number[] | number[][], tools: ServerTool[]) => string[];
+declare function createServerToolsFilter(options?: CreateServerToolsFilterOptions): ServerToolsFilterFunction;
 /**
  * Default exclusions baked into `defaultServerToolsFilter`.
  *
@@ -7941,7 +7941,21 @@ declare const DEFAULT_SERVER_TOOLS_MATCH_OPTIONS: ToolMatchOptions;
  * If you need to customize (extra excludes, different limits, opt into
  * tool-set expansion), call `createServerToolsFilter` directly.
  */
-declare const defaultServerToolsFilter: (embeddings: number[] | number[][], tools: ServerTool[]) => string[];
+declare const defaultServerToolsFilter: ServerToolsFilterFunction;
+/**
+ * Type for a server-tools filter — a function that takes prompt embeddings
+ * and the full server tool catalog and returns the names of tools to keep.
+ * Matches `useChatStorage`'s `serverTools` callback signature.
+ */
+type ServerToolsFilterFunction = ((embeddings: number[] | number[][], tools: ServerTool[]) => string[]) & {
+    /**
+     * The unconditional exclusions this filter applies, exposed by
+     * {@link createServerToolsFilter} so defer-loading can honour them without the caller
+     * repeating the list — see {@link resolveDeferredServerTools}. Absent on a hand-written
+     * filter, or on one wrapped in a plain closure.
+     */
+    readonly excludeTools?: readonly string[];
+};
 /**
  * Options for selectServerSideTools
  */
@@ -8916,6 +8930,20 @@ declare function decryptConversationTitle(encryptedTitle: string, address: strin
  * `AllTaskTypes` on the portal side, and see ai-portal
  * `docs/BACKEND_OWNED_TASK_PROMPTS.md` for the rollout.
  *
+ * ⚠ RELEASE ORDER. This union is a PUBLIC type, so a split is breaking in both
+ * directions and has to be sequenced:
+ *
+ *   1. merge + publish this package;
+ *   2. bump `@anuma/sdk` in the consumer and switch its call sites to the new
+ *      names in the same commit.
+ *
+ * A consumer on the OLD version cannot compile the new names, and a consumer on
+ * the NEW version cannot compile the retired ones (`app_inspiration` is gone
+ * here, replaced by the three `app_inspiration_*` names). Both halves of that
+ * are type-only — the wire itself always degrades safely, because the portal
+ * drops any value it does not recognise. Concretely: ai-memoryless-client#5782
+ * is blocked on this publish for exactly that reason.
+ *
  * Deliberately ABSENT: agent personas, `reflect()` when it answers the user, and
  * the app-idea chat. Those carry an open conversation with the user, so a fixed
  * server-owned prompt would be wrong rather than merely premature — the same
@@ -8923,7 +8951,7 @@ declare function decryptConversationTitle(encryptedTitle: string, address: strin
  *
  * @public
  */
-type TaskType = "title" | "commit_message" | "memory_extract" | "memory_dedup" | "memory_decay" | "memory_injection_check" | "memory_verify_support" | "memory_autosort" | "memory_topic" | "memory_consolidate" | "memory_decompose" | "memory_profile_synth" | "memory_graph" | "folder_context" | "selection_memory" | "summarize" | "style_analysis" | "classify_search" | "app_inspiration" | "spotlight_image" | "slide_image" | "media_video" | "media_audio" | "media_bg_removal" | "media_image_preset" | "tool_app_builder" | "tool_document_builder" | "tool_slides" | "connector_guidance" | "cf_task" | "xbot_intent" | "xbot_council" | "scheduled_task";
+type TaskType = "title" | "commit_message" | "memory_extract" | "memory_dedup" | "memory_decay" | "memory_injection_check" | "memory_verify_support" | "memory_autosort" | "memory_topic" | "memory_consolidate" | "memory_decompose" | "memory_profile_synth" | "memory_graph" | "folder_context" | "selection_memory" | "summarize" | "style_analysis" | "classify_search" | "app_inspiration_generate" | "app_inspiration_trends" | "app_inspiration_remix" | "spotlight_image" | "slide_image" | "slide_video" | "slide_music" | "slide_sfx" | "media_video" | "media_audio" | "media_bg_removal" | "media_image_preset" | "tool_app_builder" | "tool_document_builder" | "tool_slides" | "tool_slides_image_gen" | "connector_guidance" | "cf_task" | "xbot_intent" | "xbot_council" | "scheduled_task";
 /**
  * HTTP header naming the Class-B task a request performs.
  *

package/dist/index.mjs

@@ -2091,7 +2091,7 @@ function createServerToolsFilter(options = {}) {
   const exclude = new Set(options.excludeTools ?? []);
   const sets = options.toolSets ?? [];
   const matchOpts = options.matchOptions;
-  return (embeddings, tools) => {
+  const filter = (embeddings, tools) => {
     const matches = findMatchingTools(embeddings, tools, matchOpts);
     if (matches.length === 0) return [];
     const matchedNames = new Set(matches.map((m) => m.tool.name));
@@ -2109,6 +2109,10 @@ function createServerToolsFilter(options = {}) {
     for (const name of exclude) finalNames.delete(name);
     return [...finalNames];
   };
+  return Object.defineProperty(filter, "excludeTools", {
+    value: Object.freeze([...exclude]),
+    enumerable: false
+  });
 }
 var DEFAULT_EXCLUDED_SERVER_TOOLS = [
   "AnumaVisionMCP-anuma_analyze_image",

package/dist/react/{chunk-HNQ2ZEFF.mjs → chunk-6IBFFWCE.mjs}

@@ -5439,6 +5439,9 @@ async function decomposeQuery(query, options) {
       ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
       model: options.model ?? DEFAULT_MODEL,
       systemPrompt: SYSTEM_PROMPT,
+      // The query itself rides the user turn below, so SYSTEM_PROMPT is the whole
+      // fixed instruction — which is what lets the portal own it outright.
+      taskType: "memory_decompose",
       // Wrap the bare query in a task framing so the model treats it as
       // input to classify, not as a question to answer conversationally.
       // Bare-query inputs caused Anthropic models to respond with prose
@@ -7166,7 +7169,7 @@ function createMemoryVaultSearchTool(vaultCtx, embeddingOptions, cache, searchOp
             subQueries = decomp.subQueries;
           }
         }
-        const { recall: recall2 } = await import("./recall-F5DBVCU2.mjs");
+        const { recall: recall2 } = await import("./recall-QUWN7DJ7.mjs");
         let recallDegraded = [];
         const result = await recall2(
           query,
@@ -7419,29 +7422,29 @@ async function traverseGraphLane(query, entityCtx, options = {}) {
 var DEFAULT_REFINER_MODEL = "inclusionai/ling-2.6-flash";
 var DEFAULT_REFINER_ATTEMPTS = 1;
 var DEFAULT_REFINER_TOTAL_TIMEOUT_MS = 8e3;
+var REFINER_SYSTEM_PROMPT = `You help a memory-retrieval system decide which related topics to explore.
+
+Given a user's question and a numbered list of candidate topics/entities linked to memories found so far, pick the ones most likely to lead to memories that help ANSWER the question. Never return more than the maximum the user turn asks for. Prefer topics semantically related to the question; ignore incidental ones.
+
+Output strict JSON, no prose: { "expand": [<entity names to expand, verbatim from the list>] }`;
 function createLlmNeighborRefiner(options) {
   return {
     async refine(query, candidates, limit) {
       if (candidates.length === 0) return [];
       const numbered = candidates.map((name, i) => `[${i + 1}] ${name}`).join("\n");
-      const systemPrompt = `You help a memory-retrieval system decide which related topics to explore.
-
-Given a user's question and a numbered list of candidate topics/entities linked to memories found so far, pick the ones most likely to lead to memories that help ANSWER the question. Choose at most ${limit}. Prefer topics semantically related to the question; ignore incidental ones.
-
-Output strict JSON, no prose: { "expand": [<entity names to expand, verbatim from the list>] }`;
       const parsed = await callPortalJsonCompletion({
         ...options.apiKey !== void 0 && { apiKey: options.apiKey },
         ...options.getToken !== void 0 && { getToken: options.getToken },
         ...options.baseUrl !== void 0 && { baseUrl: options.baseUrl },
         taskType: "memory_graph",
         model: options.model ?? DEFAULT_REFINER_MODEL,
-        systemPrompt,
+        systemPrompt: REFINER_SYSTEM_PROMPT,
         userMessage: `Question: ${query}
 
 Candidate topics:
 ${numbered}
 
-Which should be expanded?`,
+Which should be expanded? Choose at most ${limit}.`,
         tag: "memory/graph-refine",
         maxAttempts: options.maxAttempts ?? DEFAULT_REFINER_ATTEMPTS,
         totalTimeoutMs: options.totalTimeoutMs ?? DEFAULT_REFINER_TOTAL_TIMEOUT_MS,