@cortexkit/magic-context 0.42.0 → 0.42.1

package/dist/index.js

@@ -16854,7 +16854,7 @@ function handleRefineResult(result, payload, input, inst) {
     payload.issues.push(issue(_iss));
   }
 }
-var $ZodType, $ZodString, $ZodStringFormat, $ZodGUID, $ZodUUID, $ZodEmail, $ZodURL, $ZodEmoji, $ZodNanoID, $ZodCUID, $ZodCUID2, $ZodULID, $ZodXID, $ZodKSUID, $ZodISODateTime, $ZodISODate, $ZodISOTime, $ZodISODuration, $ZodIPv4, $ZodIPv6, $ZodCIDRv4, $ZodCIDRv6, $ZodBase64, $ZodBase64URL, $ZodE164, $ZodJWT, $ZodNumber, $ZodNumberFormat, $ZodBoolean, $ZodUnknown, $ZodNever, $ZodArray, $ZodObject, $ZodObjectJIT, $ZodUnion, $ZodIntersection, $ZodTuple, $ZodRecord, $ZodEnum, $ZodTransform, $ZodOptional, $ZodExactOptional, $ZodNullable, $ZodDefault, $ZodPrefault, $ZodNonOptional, $ZodCatch, $ZodPipe, $ZodReadonly, $ZodCustom;
+var $ZodType, $ZodString, $ZodStringFormat, $ZodGUID, $ZodUUID, $ZodEmail, $ZodURL, $ZodEmoji, $ZodNanoID, $ZodCUID, $ZodCUID2, $ZodULID, $ZodXID, $ZodKSUID, $ZodISODateTime, $ZodISODate, $ZodISOTime, $ZodISODuration, $ZodIPv4, $ZodIPv6, $ZodCIDRv4, $ZodCIDRv6, $ZodBase64, $ZodBase64URL, $ZodE164, $ZodJWT, $ZodNumber, $ZodNumberFormat, $ZodBoolean, $ZodUnknown, $ZodNever, $ZodArray, $ZodObject, $ZodObjectJIT, $ZodUnion, $ZodIntersection, $ZodTuple, $ZodRecord, $ZodEnum, $ZodLiteral, $ZodTransform, $ZodOptional, $ZodExactOptional, $ZodNullable, $ZodDefault, $ZodPrefault, $ZodNonOptional, $ZodCatch, $ZodPipe, $ZodReadonly, $ZodCustom;
 var init_schemas = __esm(() => {
   init_checks();
   init_core();
@@ -17802,6 +17802,28 @@ var init_schemas = __esm(() => {
       return payload;
     };
   });
+  $ZodLiteral = /* @__PURE__ */ $constructor("$ZodLiteral", (inst, def) => {
+    $ZodType.init(inst, def);
+    if (def.values.length === 0) {
+      throw new Error("Cannot create literal schema with no valid values");
+    }
+    const values = new Set(def.values);
+    inst._zod.values = values;
+    inst._zod.pattern = new RegExp(`^(${def.values.map((o) => typeof o === "string" ? escapeRegex2(o) : o ? escapeRegex2(o.toString()) : String(o)).join("|")})$`);
+    inst._zod.parse = (payload, _ctx) => {
+      const input = payload.value;
+      if (values.has(input)) {
+        return payload;
+      }
+      payload.issues.push({
+        code: "invalid_value",
+        values: def.values,
+        input,
+        inst
+      });
+      return payload;
+    };
+  });
   $ZodTransform = /* @__PURE__ */ $constructor("$ZodTransform", (inst, def) => {
     $ZodType.init(inst, def);
     inst._zod.optin = "optional";
@@ -19075,6 +19097,43 @@ var formatMap, stringProcessor = (schema, ctx, _json, _params) => {
   if (values.every((v) => typeof v === "string"))
     json.type = "string";
   json.enum = values;
+}, literalProcessor = (schema, ctx, json, _params) => {
+  const def = schema._zod.def;
+  const vals = [];
+  for (const val of def.values) {
+    if (val === undefined) {
+      if (ctx.unrepresentable === "throw") {
+        throw new Error("Literal `undefined` cannot be represented in JSON Schema");
+      }
+    } else if (typeof val === "bigint") {
+      if (ctx.unrepresentable === "throw") {
+        throw new Error("BigInt literals cannot be represented in JSON Schema");
+      } else {
+        vals.push(Number(val));
+      }
+    } else {
+      vals.push(val);
+    }
+  }
+  if (vals.length === 0) {} else if (vals.length === 1) {
+    const val = vals[0];
+    json.type = val === null ? "null" : typeof val;
+    if (ctx.target === "draft-04" || ctx.target === "openapi-3.0") {
+      json.enum = [val];
+    } else {
+      json.const = val;
+    }
+  } else {
+    if (vals.every((v) => typeof v === "number"))
+      json.type = "number";
+    if (vals.every((v) => typeof v === "string"))
+      json.type = "string";
+    if (vals.every((v) => typeof v === "boolean"))
+      json.type = "boolean";
+    if (vals.every((v) => v === null))
+      json.type = "null";
+    json.enum = vals;
+  }
 }, customProcessor = (_schema, ctx, _json, _params) => {
   if (ctx.unrepresentable === "throw") {
     throw new Error("Custom types cannot be represented in JSON Schema");
@@ -19539,6 +19598,13 @@ function _enum(values, params) {
     ...normalizeParams(params)
   });
 }
+function literal(value, params) {
+  return new ZodLiteral({
+    type: "literal",
+    values: Array.isArray(value) ? value : [value],
+    ...normalizeParams(params)
+  });
+}
 function transform(fn) {
   return new ZodTransform({
     type: "transform",
@@ -19614,7 +19680,7 @@ function refine(fn, _params = {}) {
 function superRefine(fn, params) {
   return _superRefine(fn, params);
 }
-var _installedGroups, ZodType, _ZodString, ZodString, ZodStringFormat, ZodEmail, ZodGUID, ZodUUID, ZodURL, ZodEmoji, ZodNanoID, ZodCUID, ZodCUID2, ZodULID, ZodXID, ZodKSUID, ZodIPv4, ZodIPv6, ZodCIDRv4, ZodCIDRv6, ZodBase64, ZodBase64URL, ZodE164, ZodJWT, ZodNumber, ZodNumberFormat, ZodBoolean, ZodUnknown, ZodNever, ZodArray, ZodObject, ZodUnion, ZodIntersection, ZodTuple, ZodRecord, ZodEnum, ZodTransform, ZodOptional, ZodExactOptional, ZodNullable, ZodDefault, ZodPrefault, ZodNonOptional, ZodCatch, ZodPipe, ZodReadonly, ZodCustom;
+var _installedGroups, ZodType, _ZodString, ZodString, ZodStringFormat, ZodEmail, ZodGUID, ZodUUID, ZodURL, ZodEmoji, ZodNanoID, ZodCUID, ZodCUID2, ZodULID, ZodXID, ZodKSUID, ZodIPv4, ZodIPv6, ZodCIDRv4, ZodCIDRv6, ZodBase64, ZodBase64URL, ZodE164, ZodJWT, ZodNumber, ZodNumberFormat, ZodBoolean, ZodUnknown, ZodNever, ZodArray, ZodObject, ZodUnion, ZodIntersection, ZodTuple, ZodRecord, ZodEnum, ZodLiteral, ZodTransform, ZodOptional, ZodExactOptional, ZodNullable, ZodDefault, ZodPrefault, ZodNonOptional, ZodCatch, ZodPipe, ZodReadonly, ZodCustom;
 var init_schemas2 = __esm(() => {
   init_core2();
   init_core2();
@@ -20134,6 +20200,20 @@ var init_schemas2 = __esm(() => {
       });
     };
   });
+  ZodLiteral = /* @__PURE__ */ $constructor("ZodLiteral", (inst, def) => {
+    $ZodLiteral.init(inst, def);
+    ZodType.init(inst, def);
+    inst._zod.processJSONSchema = (ctx, json, params) => literalProcessor(inst, ctx, json, params);
+    inst.values = new Set(def.values);
+    Object.defineProperty(inst, "value", {
+      get() {
+        if (def.values.length > 1) {
+          throw new Error("This schema contains multiple valid literal values. Use `.values` instead.");
+        }
+        return def.values[0];
+      }
+    });
+  });
   ZodTransform = /* @__PURE__ */ $constructor("ZodTransform", (inst, def) => {
     $ZodTransform.init(inst, def);
     ZodType.init(inst, def);
@@ -20619,6 +20699,8 @@ var init_magic_context = __esm(() => {
     api_key: string2().optional().describe("API key for remote embedding provider (optional)"),
     input_type: string2().optional().describe("Default input_type for stored/indexed (passage) embeddings in the request body. Required by some openai-compatible providers (e.g. NVIDIA NIM). Omitted from the request when unset."),
     query_input_type: string2().optional().describe("Optional input_type for query (search) embeddings on asymmetric models (e.g. NVIDIA NIM 'query'). When unset, query embeddings use embedding.input_type. Passage/stored content always uses embedding.input_type."),
+    query_instruction: union([string2(), literal(false)]).optional().describe("OpenAI-compatible query prefix override. A string is prepended verbatim to search queries; false disables the built-in model-family instruction. Qwen3-Embedding, gte-Qwen instruct, e5 instruct, and Nomic families have built-in recipes. Query-only changes do not re-embed stored content. User-level only; project values are ignored."),
+    document_prefix: string2().optional().describe("OpenAI-compatible stored-document prefix override, prepended verbatim. Defaults to the model-family recipe (empty for Qwen3/gte/e5 instruct; 'search_document: ' for Nomic). Changing it changes stored vectors and triggers re-embedding. User-level only; project values are ignored."),
     truncate: string2().optional().describe("Optional truncate mode sent in the embedding request body (e.g. NVIDIA NIM accepts 'NONE' | 'START' | 'END'). Omitted from the request when unset."),
     max_input_tokens: number2().int().positive().optional().describe("Optional maximum input tokens for chunk embeddings. Defaults conservatively to 512 when omitted."),
     local_runtime: _enum(["auto", "native", "wasm"]).default("auto").describe("Local provider only: ONNX runtime selection. 'auto' uses native under Node and uses WASM under Bun versions before 1.4.0, where Bun's NAPI teardown race can panic on quit; native is restored automatically on Bun 1.4.0+. Set 'native' only to prefer speed while accepting that pre-1.4.0 Bun crash risk, or 'wasm' to avoid loading the native addon."),
@@ -20670,6 +20752,8 @@ var init_magic_context = __esm(() => {
         ...apiKey ? { api_key: apiKey } : {},
         ...inputType ? { input_type: inputType } : {},
         ...queryInputType ? { query_input_type: queryInputType } : {},
+        ...data.query_instruction !== undefined ? { query_instruction: data.query_instruction } : {},
+        ...data.document_prefix !== undefined ? { document_prefix: data.document_prefix } : {},
         ...truncate ? { truncate } : {},
         ...data.max_input_tokens ? { max_input_tokens: data.max_input_tokens } : {}
       };
@@ -20695,6 +20779,8 @@ var init_magic_context = __esm(() => {
         ...apiKey ? { api_key: apiKey } : {},
         ...inputType ? { input_type: inputType } : {},
         ...queryInputType ? { query_input_type: queryInputType } : {},
+        ...data.query_instruction !== undefined ? { query_instruction: data.query_instruction } : {},
+        ...data.document_prefix !== undefined ? { document_prefix: data.document_prefix } : {},
         ...truncate ? { truncate } : {},
         ...data.max_input_tokens ? { max_input_tokens: data.max_input_tokens } : {}
       };
@@ -21109,14 +21195,14 @@ function stripUnsafeProjectConfigFields(projectRaw) {
   const embedding = projectRaw.embedding;
   if (isPlainObject3(embedding)) {
     const removed = [];
-    for (const field of EMBEDDING_DESTINATION_FIELDS) {
+    for (const field of EMBEDDING_USER_ONLY_FIELDS) {
       if (field in embedding) {
         delete embedding[field];
         removed.push(field);
       }
     }
     if (removed.length > 0) {
-      warnings.push(`Ignoring embedding.${removed.join("/")} from project config ` + "(security: a repository cannot choose where private text is embedded).");
+      warnings.push(`Ignoring embedding.${removed.join("/")} from project config ` + "(security: a repository cannot choose where or how private text is embedded).");
     }
   }
   for (const agentKey of HIDDEN_AGENT_KEYS) {
@@ -21351,7 +21437,7 @@ function dropInheritedEmbeddingKeyOnRedirect(projectRaw, mergedRaw, userRaw) {
     "Dropped inherited user embedding api_key because project config redirected " + "embedding.endpoint without supplying its own key (security: prevents key " + "exfiltration to a repository-chosen endpoint)."
   ];
 }
-var HIDDEN_AGENT_KEYS, HARNESS_KEYS, HISTORIAN_USER_ONLY_FIELDS, PROMPT_SURFACE_USER_ONLY_FIELDS, AGENT_ESCALATION_FIELDS, EMBEDDING_DESTINATION_FIELDS, PERCENTAGE_THRESHOLD_REASON = "security: a repository may only raise compaction thresholds above the user's effective value; it cannot force earlier historian work or cloned-repo cost escalation.", TOKEN_THRESHOLD_REASON = "security: a repository may only raise execute_threshold_tokens above the user's trusted token threshold; it cannot force earlier historian work or cloned-repo cost escalation.", TOKEN_THRESHOLD_INTRODUCTION_REASON = "security: a repository cannot introduce a new execute_threshold_tokens override when the user has no trusted token threshold for that key; that could force earlier historian work or cloned-repo cost escalation.", PROTECTED_TOKENS_REASON = "security: a repository may only raise protected_tokens above the resolved user-or-derived floor; it cannot lower protection.", PROTECTED_TOKENS_TIER_OVERRIDES;
+var HIDDEN_AGENT_KEYS, HARNESS_KEYS, HISTORIAN_USER_ONLY_FIELDS, PROMPT_SURFACE_USER_ONLY_FIELDS, AGENT_ESCALATION_FIELDS, EMBEDDING_USER_ONLY_FIELDS, PERCENTAGE_THRESHOLD_REASON = "security: a repository may only raise compaction thresholds above the user's effective value; it cannot force earlier historian work or cloned-repo cost escalation.", TOKEN_THRESHOLD_REASON = "security: a repository may only raise execute_threshold_tokens above the user's trusted token threshold; it cannot force earlier historian work or cloned-repo cost escalation.", TOKEN_THRESHOLD_INTRODUCTION_REASON = "security: a repository cannot introduce a new execute_threshold_tokens override when the user has no trusted token threshold for that key; that could force earlier historian work or cloned-repo cost escalation.", PROTECTED_TOKENS_REASON = "security: a repository may only raise protected_tokens above the resolved user-or-derived floor; it cannot lower protection.", PROTECTED_TOKENS_TIER_OVERRIDES;
 var init_project_security = __esm(() => {
   init_magic_context();
   HIDDEN_AGENT_KEYS = ["historian", "dreamer"];
@@ -21359,7 +21445,13 @@ var init_project_security = __esm(() => {
   HISTORIAN_USER_ONLY_FIELDS = PER_HARNESS_MIGRATION_INVENTORY.historian.migrated_execution;
   PROMPT_SURFACE_USER_ONLY_FIELDS = ["guidance_override_path", "tool_descriptions"];
   AGENT_ESCALATION_FIELDS = ["prompt", "permission", "tools"];
-  EMBEDDING_DESTINATION_FIELDS = ["endpoint", "provider", "fallback_provider"];
+  EMBEDDING_USER_ONLY_FIELDS = [
+    "endpoint",
+    "provider",
+    "fallback_provider",
+    "query_instruction",
+    "document_prefix"
+  ];
   PROTECTED_TOKENS_TIER_OVERRIDES = Symbol.for("@cortexkit/magic-context/protected-tokens-tier-overrides");
 });
 
@@ -35631,7 +35723,8 @@ function getSynapseBatchRequestKey(args) {
     allow_equivalent: false,
     accept_declared: false,
     ids: args.items.map((item) => item.id),
-    content_sha256: args.items.map((item) => item.contentSha256)
+    content_sha256: args.items.map((item) => item.contentSha256),
+    ...args.purpose === "query" ? { purpose: args.purpose } : {}
   }));
 }
 function hashContent(text) {
@@ -35888,7 +35981,7 @@ class SynapseEmbeddingProvider {
     })();
     return this.initializing;
   }
-  async embed(text, signal) {
+  async embed(text, signal, purpose = "passage") {
     if (!await this.initialize() || signal?.aborted || !this.metadata)
       return null;
     if (estimateTokens(text) > this.metadata.max_tokens)
@@ -35898,6 +35991,7 @@ class SynapseEmbeddingProvider {
       const value = await this.callWithRetry("embed.query", this.requestConstraints({
         id,
         text,
+        purpose,
         deadline_ms: this.options.queryTimeoutMs ?? SYNAPSE_DEFAULT_QUERY_TIMEOUT_MS
       }), this.options.queryTimeoutMs ?? SYNAPSE_DEFAULT_QUERY_TIMEOUT_MS, true, signal);
       const extracted = extractVector(value);
@@ -35917,7 +36011,7 @@ class SynapseEmbeddingProvider {
       return null;
     }
   }
-  async embedBatch(texts, signal) {
+  async embedBatch(texts, signal, purpose = "passage") {
     if (texts.length === 0)
       return [];
     const items = texts.map((text, index) => ({
@@ -35925,10 +36019,10 @@ class SynapseEmbeddingProvider {
       text,
       contentSha256: hashContent(text)
     }));
-    const map = await this.embedItems(items, signal);
+    const map = await this.embedItems(items, signal, purpose);
     return items.map((item) => map.get(item.id) ?? null);
   }
-  async embedItems(items, signal) {
+  async embedItems(items, signal, purpose = "passage") {
     const output = new Map;
     if (items.length === 0 || !await this.initialize() || !this.metadata || signal?.aborted) {
       return output;
@@ -35941,12 +36035,12 @@ class SynapseEmbeddingProvider {
       const page = this.nextPage(eligibleItems, start);
       start += page.length;
       try {
-        const requestKey = this.requestKey(page);
+        const requestKey = this.requestKey(page, purpose);
         let body = {};
         let restarted = false;
         for (;; ) {
           try {
-            body = await this.callWithRetry("embed.batch", this.batchRequest(page, requestKey), this.options.batchTimeoutMs ?? SYNAPSE_DEFAULT_BATCH_TIMEOUT_MS, true, signal);
+            body = await this.callWithRetry("embed.batch", this.batchRequest(page, requestKey, purpose), this.options.batchTimeoutMs ?? SYNAPSE_DEFAULT_BATCH_TIMEOUT_MS, true, signal);
             const first = responseBody(body);
             const jobId = typeof first.job_id === "string" ? first.job_id : null;
             if (jobId)
@@ -36016,24 +36110,26 @@ class SynapseEmbeddingProvider {
       accept_declared: false
     };
   }
-  batchRequest(items, requestKey) {
+  batchRequest(items, requestKey, purpose) {
     return this.requestConstraints({
       items: items.map((item) => ({
         id: item.id,
         text: item.text,
         content_sha256: item.contentSha256
       })),
-      request_key: requestKey
+      request_key: requestKey,
+      purpose
     });
   }
-  requestKey(items) {
+  requestKey(items, purpose) {
     if (!this.metadata)
       throw new SynapseEmbeddingError("transport", "Synapse metadata is unavailable");
     return getSynapseBatchRequestKey({
       model: this.metadata.model,
       fingerprint: this.metadata.fingerprint,
       tableEpoch: this.metadata.table_epoch,
-      items
+      items,
+      purpose
     });
   }
   async pollBatch(jobId, requestKey, signal) {
@@ -36937,12 +37033,16 @@ var init_diagnostics_opencode = __esm(() => {
   init_redaction2();
   import_comment_json9 = __toESM(require_src3(), 1);
 });
+// ../plugin/src/features/magic-context/memory/embedding-model-match.ts
+var init_embedding_model_match = () => {};
+
 // ../plugin/src/features/magic-context/memory/normalize-hash.ts
 var init_normalize_hash = () => {};
 
 // ../plugin/src/features/magic-context/memory/embedding-identity.ts
 var init_embedding_identity = __esm(() => {
   init_magic_context();
+  init_embedding_model_match();
   init_embedding_synapse();
   init_normalize_hash();
 });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cortexkit/magic-context",
-    "version": "0.42.0",
+    "version": "0.42.1",
     "description": "Unified CLI for Magic Context — setup, doctor, and migration across OpenCode, Pi, and OMP",
     "keywords": [
         "opencode",