@runtypelabs/sdk 9.8.0 → 9.9.1

package/dist/index.mjs

@@ -37,6 +37,7 @@ var UNIFIED_EVENT_TYPES = /* @__PURE__ */ new Set([
   "approval_complete",
   "await",
   "error",
+  "context_notice",
   "ping",
   "custom"
 ]);
@@ -4717,6 +4718,7 @@ var SkillsNamespace = class {
 
 // src/agents-namespace.ts
 var AGENT_CONFIG_KEYS = [
+  "contextManagement",
   "model",
   "systemPrompt",
   "temperature",
@@ -5716,27 +5718,6 @@ var SurfacesNamespace = class {
   }
 };
 
-// src/transform.ts
-function transformResponse(data) {
-  return data;
-}
-function transformRequest(data) {
-  return data;
-}
-function transformQueryParams(params) {
-  const result = {};
-  for (const [key, value] of Object.entries(params)) {
-    if (value !== void 0 && value !== null) {
-      if (Array.isArray(value)) {
-        result[key] = value.join(",");
-      } else {
-        result[key] = String(value);
-      }
-    }
-  }
-  return result;
-}
-
 // src/types.ts
 function isCatalogClientToolRef(entry) {
   return entry.catalog === "runtype-mcp";
@@ -5819,7 +5800,7 @@ var RuntypeClient = class {
       method: "GET",
       headers: this.headers
     });
-    return this.transformResponse(response);
+    return response;
   }
   /**
    * Generic POST request
@@ -5831,7 +5812,7 @@ var RuntypeClient = class {
       headers: { ...this.headers, ...extraHeaders },
       body: data ? JSON.stringify(data) : void 0
     });
-    return this.transformResponse(response);
+    return response;
   }
   /**
    * Generic PUT request
@@ -5843,7 +5824,7 @@ var RuntypeClient = class {
       headers: this.headers,
       body: data ? JSON.stringify(data) : void 0
     });
-    return this.transformResponse(response);
+    return response;
   }
   /**
    * Generic PATCH request
@@ -5855,7 +5836,7 @@ var RuntypeClient = class {
       headers: this.headers,
       body: data ? JSON.stringify(data) : void 0
     });
-    return this.transformResponse(response);
+    return response;
   }
   /**
    * Generic DELETE request
@@ -5866,7 +5847,7 @@ var RuntypeClient = class {
       method: "DELETE",
       headers: this.headers
     });
-    return this.transformResponse(response);
+    return response;
   }
   /**
    * Generic request that returns raw Response for streaming
@@ -5892,13 +5873,13 @@ var RuntypeClient = class {
    */
   async dispatch(config) {
     const normalized = normalizeDispatchRequest(config);
-    const request6 = transformRequest({
+    const request6 = {
       ...normalized,
       options: {
         ...normalized.options,
         streamResponse: true
       }
-    });
+    };
     return this.requestStream("/dispatch", {
       method: "POST",
       body: JSON.stringify(request6)
@@ -5957,35 +5938,15 @@ var RuntypeClient = class {
    * Make HTTP request with timeout and error handling
    */
   async makeRequest(url, options) {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      const response = await fetch(url, {
-        ...options,
-        signal: controller.signal
-      });
-      clearTimeout(timeoutId);
-      if (!response.ok) {
-        const errorText = await response.text();
-        throw new Error(
-          `API request failed: ${response.status} ${response.statusText} - ${errorText}`
-        );
-      }
-      if (response.status === 204) {
-        return null;
-      }
-      const contentType = response.headers.get("content-type");
-      if (contentType?.includes("application/json")) {
-        return response.json();
-      }
-      return response.text();
-    } catch (error) {
-      clearTimeout(timeoutId);
-      if (error instanceof Error && error.name === "AbortError") {
-        throw new Error(`Request timeout after ${this.timeout}ms`, { cause: error });
-      }
-      throw error;
+    const response = await this.makeRawRequest(url, options);
+    if (response.status === 204) {
+      return null;
+    }
+    const contentType = response.headers.get("content-type");
+    if (contentType?.includes("application/json")) {
+      return response.json();
     }
+    return response.text();
   }
   /**
    * Make HTTP request that returns raw Response (for streaming)
@@ -6014,12 +5975,6 @@ var RuntypeClient = class {
       throw error;
     }
   }
-  /**
-   * Transform response (placeholder for snake_case to camelCase)
-   */
-  transformResponse(response) {
-    return response;
-  }
 };
 var Runtype = class {
   /**
@@ -6298,9 +6253,24 @@ var Runtype = class {
   }
 };
 
+// src/transform.ts
+function transformQueryParams(params) {
+  const result = {};
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0 && value !== null) {
+      if (Array.isArray(value)) {
+        result[key] = value.join(",");
+      } else {
+        result[key] = String(value);
+      }
+    }
+  }
+  return result;
+}
+
 // src/version.ts
 var FALLBACK_VERSION = "0.0.0";
-var SDK_VERSION = "9.8.0".length > 0 ? "9.8.0" : FALLBACK_VERSION;
+var SDK_VERSION = "9.9.1".length > 0 ? "9.9.1" : FALLBACK_VERSION;
 var RUNTYPE_CLIENT_KIND = "sdk";
 var SDK_USER_AGENT = `runtype-sdk/${SDK_VERSION} (typescript)`;
 
@@ -6734,6 +6704,7 @@ function applyGeneratedRuntimeToolProposalToDispatchRequest(request6, proposal,
 
 // src/offload-markers.ts
 var LEDGER_ARTIFACT_LINE_PREFIX = "Ledger artifact: ";
+var SPILL_MARKER_PATTERN = /\[Output saved to (art_[A-Za-z0-9_-]+) \(([\d,]+) chars?\); read_offloaded_output to view\]/;
 function formatChars(charLength) {
   return charLength.toLocaleString("en-US");
 }
@@ -6749,9 +6720,13 @@ function buildLedgerOffloadReference(details) {
     `Use read_offloaded_output with id "${details.outputId}" to retrieve the full output if needed.`
   ].join("\n");
 }
+function buildObservationMaskMarker(details) {
+  return `[Output from ${details.toolName} masked \u2014 re-run the tool if needed]`;
+}
 var DECLARED_CHARS_PATTERNS = [
   /—\s*([\d,]+)\s+chars?\s+(?:stored|saved)/i,
-  /\(([\d,]+)\s+chars?\)\s+saved/i
+  /\(([\d,]+)\s+chars?\)\s+saved/i,
+  /\(([\d,]+)\s+chars?\);\s*read_offloaded_output/i
 ];
 function extractDeclaredToolResultChars(value) {
   if (typeof value !== "string") return void 0;
@@ -6763,13 +6738,82 @@ function extractDeclaredToolResultChars(value) {
   }
   return void 0;
 }
+function parseSpillMarkerArtifactId(value) {
+  if (typeof value !== "string") return void 0;
+  const match = SPILL_MARKER_PATTERN.exec(value);
+  if (!match?.[1] || !match[2]) return void 0;
+  const charLength = Number.parseInt(match[2].replace(/,/g, ""), 10);
+  if (!Number.isFinite(charLength) || charLength <= 0) return void 0;
+  return match[1];
+}
 function parseOffloadedOutputId(value) {
-  return /\bread_offloaded_output\s+with\s+id\s+"([^"]+)"/i.exec(value)?.[1] || /\[Output offloaded as\s+([a-zA-Z0-9_-]+)/i.exec(value)?.[1] || void 0;
+  return /\bread_offloaded_output\s+with\s+id\s+"([^"]+)"/i.exec(value)?.[1] || /\[Output offloaded as\s+([a-zA-Z0-9_-]+)/i.exec(value)?.[1] || parseSpillMarkerArtifactId(value) || void 0;
 }
 function parseLedgerArtifactRelativePath(value) {
   return value.split("\n").find((line) => line.startsWith(LEDGER_ARTIFACT_LINE_PREFIX))?.slice(LEDGER_ARTIFACT_LINE_PREFIX.length).trim();
 }
 
+// src/context-budget.ts
+var DEFAULT_CHARS_PER_TOKEN = 4;
+var MESSAGE_OVERHEAD_TOKENS = 6;
+var TOOL_ENTRY_OVERHEAD_TOKENS = 12;
+var CONTENT_PART_OVERHEAD_TOKENS = 4;
+var IMAGE_PART_TOKENS = 85;
+var MAX_DATA_PART_TOKENS = 200;
+function estimateTokensByChars(text) {
+  if (!text) return 0;
+  return Math.ceil(text.length / DEFAULT_CHARS_PER_TOKEN);
+}
+function estimateUnknownValueTokens(value, estimate = estimateTokensByChars) {
+  if (typeof value === "string") return estimate(value);
+  try {
+    return estimate(JSON.stringify(value) ?? "");
+  } catch {
+    return 0;
+  }
+}
+function estimateContentTokens(content, estimate = estimateTokensByChars) {
+  if (typeof content === "string") return estimate(content);
+  if (!Array.isArray(content)) return 0;
+  return content.reduce((total, part) => {
+    let partTotal = CONTENT_PART_OVERHEAD_TOKENS;
+    if (typeof part.text === "string") partTotal += estimate(part.text);
+    if (typeof part.image === "string") partTotal += IMAGE_PART_TOKENS;
+    if (typeof part.data === "string") {
+      partTotal += Math.min(MAX_DATA_PART_TOKENS, estimate(part.data));
+    }
+    return total + partTotal;
+  }, 0);
+}
+function estimateToolCallTokens(toolCalls, estimate = estimateTokensByChars) {
+  if (!toolCalls || toolCalls.length === 0) return 0;
+  return toolCalls.reduce(
+    (sum, toolCall) => sum + TOOL_ENTRY_OVERHEAD_TOKENS + estimate(toolCall.toolName) + estimateUnknownValueTokens(toolCall.args, estimate),
+    0
+  );
+}
+function estimateToolResultTokens(toolResults, options) {
+  if (!toolResults || toolResults.length === 0) return 0;
+  const estimate = options?.estimate ?? estimateTokensByChars;
+  return toolResults.reduce((sum, toolResult) => {
+    const resultTokens = estimateUnknownValueTokens(toolResult.result, estimate);
+    const declaredChars = options?.useDeclaredSize ? extractDeclaredToolResultChars(toolResult.result) : void 0;
+    const declaredTokens = typeof declaredChars === "number" ? Math.ceil(declaredChars / DEFAULT_CHARS_PER_TOKEN) : 0;
+    return sum + TOOL_ENTRY_OVERHEAD_TOKENS + estimate(toolResult.toolName) + Math.max(resultTokens, declaredTokens);
+  }, 0);
+}
+function estimateMessageTokens(message, options) {
+  const estimate = options?.estimate ?? estimateTokensByChars;
+  return MESSAGE_OVERHEAD_TOKENS + estimateContentTokens(message.content, estimate) + estimateToolCallTokens(message.toolCalls, estimate) + estimateToolResultTokens(message.toolResults, {
+    ...options?.useDeclaredToolResultSizes ? { useDeclaredSize: true } : {},
+    estimate
+  });
+}
+function modelIdSupportsProviderNativeCompaction(modelId) {
+  const normalized = modelId?.trim().toLowerCase() ?? "";
+  return normalized.includes("claude") || normalized.includes("anthropic");
+}
+
 // src/workflow-utils.ts
 function normalizeCandidatePath(candidatePath) {
   return candidatePath.trim().replace(/\\/g, "/").replace(/^\.?\//, "").replace(/\/+/g, "/");
@@ -10762,7 +10806,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
         )
       };
     }
-    return { ...tr, result: `[Output from ${tr.toolName} masked \u2014 re-run the tool if needed]` };
+    return { ...tr, result: buildObservationMaskMarker({ toolName: tr.toolName }) };
   }
   isMarathonArtifactPath(candidatePath) {
     const normalized = this.normalizeCandidatePath(candidatePath).toLowerCase();
@@ -11845,57 +11889,29 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     if (strategy === "summary_fallback") {
       return "summary_fallback";
     }
-    const normalizedModelId = modelId?.trim().toLowerCase() ?? "";
-    const supportsAnthropicNativeCompaction = normalizedModelId.includes("claude") || normalizedModelId.includes("anthropic");
+    const supportsAnthropicNativeCompaction = modelIdSupportsProviderNativeCompaction(modelId);
     if (strategy === "provider_native") {
       return supportsAnthropicNativeCompaction ? "provider_native" : "summary_fallback";
     }
     return supportsAnthropicNativeCompaction ? "provider_native" : "summary_fallback";
   }
   estimateTextTokens(text) {
-    if (!text) return 0;
-    return Math.ceil(text.length / 4);
-  }
-  estimateUnknownTokens(value) {
-    if (typeof value === "string") return this.estimateTextTokens(value);
-    try {
-      return this.estimateTextTokens(JSON.stringify(value));
-    } catch {
-      return 0;
-    }
+    return estimateTokensByChars(text);
   }
   extractDeclaredToolResultChars(value) {
     return extractDeclaredToolResultChars(value);
   }
   estimateMessageContentTokens(content) {
-    if (typeof content === "string") return this.estimateTextTokens(content);
-    return content.reduce((total, part) => {
-      if (typeof part.text === "string") total += this.estimateTextTokens(part.text);
-      if (typeof part.image === "string") total += 85;
-      if (typeof part.data === "string") {
-        total += Math.min(200, this.estimateTextTokens(part.data));
-      }
-      return total + 4;
-    }, 0);
+    return estimateContentTokens(content);
   }
   estimateToolCallTokens(toolCalls) {
-    if (!toolCalls || toolCalls.length === 0) return 0;
-    return toolCalls.reduce(
-      (sum, toolCall) => sum + 12 + this.estimateTextTokens(toolCall.toolName) + this.estimateUnknownTokens(toolCall.args),
-      0
-    );
+    return estimateToolCallTokens(toolCalls);
   }
   estimateToolResultTokens(toolResults, options) {
-    if (!toolResults || toolResults.length === 0) return 0;
-    return toolResults.reduce((sum, toolResult) => {
-      const resultTokens = this.estimateUnknownTokens(toolResult.result);
-      const declaredChars = options?.useDeclaredSize ? this.extractDeclaredToolResultChars(toolResult.result) : void 0;
-      const declaredTokens = typeof declaredChars === "number" ? Math.ceil(declaredChars / 4) : 0;
-      return sum + 12 + this.estimateTextTokens(toolResult.toolName) + Math.max(resultTokens, declaredTokens);
-    }, 0);
+    return estimateToolResultTokens(toolResults, options);
   }
   estimateMessageTokens(message) {
-    return 6 + this.estimateMessageContentTokens(message.content) + this.estimateToolCallTokens(message.toolCalls) + this.estimateToolResultTokens(message.toolResults);
+    return estimateMessageTokens(message);
   }
   estimateConversationTokens(messages) {
     return messages.reduce((sum, message) => sum + this.estimateMessageTokens(message), 0);
@@ -11931,7 +11947,7 @@ var _AgentsEndpoint = class _AgentsEndpoint {
     }));
     const payload = [...localToolDefinitions, ...builtinToolSchemas];
     if (payload.length === 0) return 0;
-    return this.estimateUnknownTokens(payload);
+    return estimateUnknownValueTokens(payload);
   }
   async loadBuiltinToolSchemas(toolIds) {
     if (!toolIds || toolIds.length === 0) return [];
@@ -13409,7 +13425,7 @@ var RuntypeClient2 = class {
       method: "GET",
       headers: this.headers
     });
-    return transformResponse(response);
+    return response;
   }
   /**
    * Conditional GET (`ETag` / `If-None-Match`).
@@ -13432,7 +13448,7 @@ var RuntypeClient2 = class {
     if (!response.ok) {
       throw await this.createApiError(response);
     }
-    const data = transformResponse(await response.json());
+    const data = await response.json();
     return { notModified: false, etag, data };
   }
   /**
@@ -13443,9 +13459,9 @@ var RuntypeClient2 = class {
     const response = await this.makeRequest(url, {
       method: "POST",
       headers: { ...this.headers, ...extraHeaders },
-      body: data ? JSON.stringify(transformRequest(data)) : void 0
+      body: data ? JSON.stringify(data) : void 0
     });
-    return transformResponse(response);
+    return response;
   }
   /**
    * POST request with FormData support for file uploads
@@ -13459,7 +13475,7 @@ var RuntypeClient2 = class {
       headers,
       body: formData
     });
-    return transformResponse(response);
+    return response;
   }
   /**
    * POST request with a raw binary body (e.g. application/zip bundle uploads).
@@ -13473,7 +13489,7 @@ var RuntypeClient2 = class {
       // WORKAROUND(docs/why/packages/client/src.md#ts-5-7-types-uint8array-over-arraybufferlike-whi): TS 5.7 types Uint8Array over ArrayBufferLike, which no longer overlaps DOM BodyInit, though the
       body
     });
-    return transformResponse(response);
+    return response;
   }
   /**
    * Generic request that returns raw Response for streaming
@@ -13484,18 +13500,9 @@ var RuntypeClient2 = class {
       ...this.headers,
       ...options.headers
     };
-    let body = options.body;
-    if (body && typeof body === "string" && headers["Content-Type"]?.includes("application/json")) {
-      try {
-        const parsed = JSON.parse(body);
-        body = JSON.stringify(transformRequest(parsed));
-      } catch {
-      }
-    }
     return this.makeRawRequest(url, {
       ...options,
-      headers,
-      body
+      headers
     });
   }
   /**
@@ -13506,9 +13513,9 @@ var RuntypeClient2 = class {
     const response = await this.makeRequest(url, {
       method: "PUT",
       headers: this.headers,
-      body: data ? JSON.stringify(transformRequest(data)) : void 0
+      body: data ? JSON.stringify(data) : void 0
     });
-    return transformResponse(response);
+    return response;
   }
   /**
    * Generic PATCH request
@@ -13518,9 +13525,9 @@ var RuntypeClient2 = class {
     const response = await this.makeRequest(url, {
       method: "PATCH",
       headers: this.headers,
-      body: data ? JSON.stringify(transformRequest(data)) : void 0
+      body: data ? JSON.stringify(data) : void 0
     });
-    return transformResponse(response);
+    return response;
   }
   /**
    * Generic DELETE request
@@ -13530,9 +13537,9 @@ var RuntypeClient2 = class {
     const response = await this.makeRequest(url, {
       method: "DELETE",
       headers: this.headers,
-      body: data ? JSON.stringify(transformRequest(data)) : void 0
+      body: data ? JSON.stringify(data) : void 0
     });
-    return transformResponse(response);
+    return response;
   }
   /**
    * Build full URL with query parameters
@@ -14472,6 +14479,7 @@ export {
   buildEmptySessionNudge,
   buildGeneratedRuntimeToolGateOutput,
   buildLedgerOffloadReference,
+  buildObservationMaskMarker,
   buildPolicyGuidance,
   buildSendViewOffloadMarker,
   calledTool,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/sdk",
-  "version": "9.8.0",
+  "version": "9.9.1",
   "type": "module",
   "description": "TypeScript SDK for the Runtype API with fluent methods. Use it to quickly realize AI products, agents, and workflows.",
   "main": "dist/index.cjs",
@@ -24,6 +24,7 @@
   ],
   "dependencies": {},
   "devDependencies": {
+    "@runtypelabs/shared": "3.44.0",
     "openapi-typescript": "^7.13.0",
     "tsup": "^8.0.2",
     "typescript": "^6.0.3",