@maximem/synap-js-sdk 0.5.2 → 0.5.4

package/dist/index.d.cts

@@ -501,6 +501,21 @@ interface FetchOptions {
     mode?: string;
     precision_level?: string;
     precisionLevel?: string;
+    /**
+     * The moment the question is being asked, so the server can resolve a period
+     * the question names ("in March", "two months ago") instead of counting back
+     * from now.
+     *
+     * Sent only when provided, like `precision_level`: the golden payloads in
+     * CONTRACT/conformance/request_payloads.json are byte-for-byte, so an
+     * always-present key would break every existing case.
+     *
+     * Lenient on the server: `"2023-03-11"`, `"2023/03/11 21:26"` and
+     * `"2023/03/11 (Sat) 21:26"` all parse, and anything unreadable falls back to
+     * now with a warning rather than failing the read.
+     */
+    query_date?: string;
+    queryDate?: string;
     /** Sent only when explicitly false, matching the Python controllers. */
     include_conversation_context?: boolean;
     /**
@@ -1367,6 +1382,8 @@ interface UnifiedFetchOptions {
     types?: string[];
     mode?: string;
     precision_level?: string;
+    /** The moment the question is being asked. See FetchOptions.query_date. */
+    query_date?: string;
     include_conversation_context?: boolean;
     scopes?: string[];
     include_scope_labels?: boolean;
@@ -1537,7 +1554,7 @@ declare class SynapClient {
  * build when the two disagree, which is the only thing that makes a manual
  * publish safe.
  */
-declare const SDK_VERSION = "0.5.2";
+declare const SDK_VERSION = "0.5.4";
 
 /**
  * BM25 scorer for the anticipation cache.

package/dist/index.d.ts

@@ -501,6 +501,21 @@ interface FetchOptions {
     mode?: string;
     precision_level?: string;
     precisionLevel?: string;
+    /**
+     * The moment the question is being asked, so the server can resolve a period
+     * the question names ("in March", "two months ago") instead of counting back
+     * from now.
+     *
+     * Sent only when provided, like `precision_level`: the golden payloads in
+     * CONTRACT/conformance/request_payloads.json are byte-for-byte, so an
+     * always-present key would break every existing case.
+     *
+     * Lenient on the server: `"2023-03-11"`, `"2023/03/11 21:26"` and
+     * `"2023/03/11 (Sat) 21:26"` all parse, and anything unreadable falls back to
+     * now with a warning rather than failing the read.
+     */
+    query_date?: string;
+    queryDate?: string;
     /** Sent only when explicitly false, matching the Python controllers. */
     include_conversation_context?: boolean;
     /**
@@ -1367,6 +1382,8 @@ interface UnifiedFetchOptions {
     types?: string[];
     mode?: string;
     precision_level?: string;
+    /** The moment the question is being asked. See FetchOptions.query_date. */
+    query_date?: string;
     include_conversation_context?: boolean;
     scopes?: string[];
     include_scope_labels?: boolean;
@@ -1537,7 +1554,7 @@ declare class SynapClient {
  * build when the two disagree, which is the only thing that makes a manual
  * publish safe.
  */
-declare const SDK_VERSION = "0.5.2";
+declare const SDK_VERSION = "0.5.4";
 
 /**
  * BM25 scorer for the anticipation cache.

package/dist/index.js

@@ -536,6 +536,7 @@ function buildFetchRequest(scope, options) {
   const searchQuery = opt(options, "search_query", "searchQuery");
   const maxResults = opt(options, "max_results", "maxResults") ?? 10;
   const precisionLevel = opt(options, "precision_level", "precisionLevel") ?? "high";
+  const queryDate = opt(options, "query_date", "queryDate");
   const mode = options.mode ?? "fast";
   if (searchQuery !== void 0 && !Array.isArray(searchQuery)) {
     throw new InvalidInputError("search_query must be an array when provided");
@@ -551,6 +552,7 @@ function buildFetchRequest(scope, options) {
     mode
   };
   if (precisionLevel !== "high") body["precision_level"] = precisionLevel;
+  if (queryDate) body["query_date"] = queryDate;
   if (options.include_conversation_context === false) {
     body["include_conversation_context"] = false;
   }
@@ -1391,7 +1393,22 @@ var KNOWN_EVENT_TYPES = /* @__PURE__ */ new Set([
 ]);
 function toolResultJson(result) {
   if (result === void 0 || result === null) return "";
-  return typeof result === "string" ? result : JSON.stringify(result);
+  return typeof result === "string" ? result : jsonOrText(result);
+}
+function jsonOrText(value) {
+  try {
+    const out = JSON.stringify(
+      value,
+      (_k, v) => typeof v === "bigint" ? String(v) : v
+    );
+    return out === void 0 ? String(value) : out;
+  } catch {
+    try {
+      return String(value);
+    } catch {
+      return "";
+    }
+  }
 }
 function createInstanceNamespace(credentials, cache, onTurn) {
   let client = null;
@@ -1538,7 +1555,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
         // Python serialises tool_args with json.dumps into tool_args_json.
         tool_args_json: (() => {
           const a = options.tool_args ?? options.toolArgs;
-          return a === void 0 ? "" : JSON.stringify(a);
+          return a === void 0 ? "" : jsonOrText(a);
         })(),
         tool_result_json: toolResultJson(options.tool_result ?? options.toolResult),
         tool_call_id: options.tool_call_id ?? options.toolCallId ?? "",
@@ -1612,7 +1629,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.5.2";
+var SDK_VERSION = "0.5.4";
 
 // src/registry.ts
 var instances = /* @__PURE__ */ new Map();
@@ -2611,6 +2628,7 @@ var SynapClient = class {
     this.#fetchHooks = {
       beforeFetch: (scope, options2) => {
         const o2 = options2;
+        if (o2["query_date"] ?? o2["queryDate"]) return null;
         const attempt = tryServeFromCache(
           this.#anticipationCache,
           scope,
@@ -2879,6 +2897,7 @@ var SynapClient = class {
       types,
       mode = "fast",
       precision_level: precisionLevel = "high",
+      query_date: queryDate,
       include_conversation_context: includeConversationContext = true,
       scopes,
       include_scope_labels: includeScopeLabels = false,
@@ -2893,7 +2912,11 @@ var SynapClient = class {
       max_results: maxResults,
       types,
       mode,
-      precision_level: precisionLevel
+      precision_level: precisionLevel,
+      // In `shared` so it reaches all four branches at once. The Python edit
+      // threaded three call sites by hand and missed the client branch, which
+      // sits one indent deeper; spreading removes that whole class of miss.
+      query_date: queryDate
     };
     const labels = [];
     const tasks = [];