@mindstudio-ai/agent 0.1.100 → 0.1.102

package/dist/index.js

@@ -1968,12 +1968,14 @@ var Store = class {
   async put(content, options) {
     const ext = extensionFor(options?.filename);
     const key = options?.key ?? (options?.contentAddressed ? `${createHash("sha256").update(content).digest("hex")}${ext}` : `${randomUUID()}${ext}`);
+    const cacheControl = options?.cacheControl ?? (!options?.key && this._access === "public" ? "public, max-age=31536000, immutable" : void 0);
     const meta = await this._call("put", {
       store: this._store,
       access: this._access,
       key,
       body: toBase64(content),
-      ...options?.contentType ? { contentType: options.contentType } : {}
+      ...options?.contentType ? { contentType: options.contentType } : {},
+      ...cacheControl ? { cacheControl } : {}
     });
     return this._toFile(key, meta);
   }
@@ -2082,7 +2084,8 @@ var Store = class {
       key,
       ...options?.contentType ? { contentType: options.contentType } : {},
       ...maxSize ? { maxSize } : {},
-      ...options?.expiresIn ? { expiresIn: options.expiresIn } : {}
+      ...options?.expiresIn ? { expiresIn: options.expiresIn } : {},
+      ...options?.cacheControl ? { cacheControl: options.cacheControl } : {}
     });
     return {
       key,
@@ -2275,6 +2278,9 @@ function createVoice(call) {
   };
 }
 
+// src/task/index.ts
+import { randomUUID as randomUUID2 } from "crypto";
+
 // src/generated/metadata.ts
 var stepMetadata = {
   "activeCampaignAddNote": {
@@ -3134,28 +3140,28 @@ var stepMetadata = {
   "scrapeUrl": {
     stepType: "scrapeUrl",
     description: "Extract text, HTML, or structured content from one or more web pages.",
-    usageNotes: '- Accepts a single URL or multiple URLs (as a JSON array, comma-separated, or newline-separated).\n- Output format controls the result shape: "text" returns markdown, "html" returns raw HTML, "json" returns structured scraper data.\n- Can optionally capture a screenshot of each page.',
-    inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "URL(s) to scrape. Accepts a single URL, JSON array, or comma/newline-separated list" }, "service": { "enum": ["default", "firecrawl"], "type": "string", "description": "Scraping service to use" }, "autoEnhance": { "type": "boolean", "description": "Whether to enable enhanced scraping for social media URLs (e.g. Twitter, LinkedIn)" }, "outputFormat": { "enum": ["text", "json", "html"], "type": "string", "description": "Output format: text returns markdown, html returns raw HTML, json returns structured scraper data" }, "pageOptions": { "type": "object", "properties": { "onlyMainContent": { "type": "boolean", "description": "Whether to extract only the main content of the page, excluding navigation, footers, etc." }, "screenshot": { "type": "boolean", "description": "Whether to capture a screenshot of the page" }, "waitFor": { "type": "number", "description": "Milliseconds to wait before scraping (0 for immediate)" }, "replaceAllPathsWithAbsolutePaths": { "type": "boolean", "description": "Whether to convert relative URLs to absolute URLs in the result" }, "headers": { "type": "object", "properties": {}, "required": [], "description": "Custom HTTP request headers as key-value pairs" }, "removeTags": { "type": "array", "items": { "type": "string" }, "description": "HTML tags to remove from the scraped result" }, "mobile": { "type": "boolean", "description": "Whether to scrape using a mobile user-agent" } }, "required": ["onlyMainContent", "screenshot", "waitFor", "replaceAllPathsWithAbsolutePaths", "headers", "removeTags", "mobile"], "description": "Page-level scraping options (content filtering, screenshots, headers, etc.)" } }, "required": ["url"] },
-    outputSchema: { "type": "object", "properties": { "content": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "properties": {}, "required": [], "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"], "description": "Set when the scrape failed. `text`/`html` still carry the human-readable error so existing callers behave as before, but callers that care \u2014 billing, in particular \u2014 can tell a failure from real page content." } }, "required": ["text", "html"] }, { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "properties": {}, "required": [], "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"], "description": "Set when the scrape failed. `text`/`html` still carry the human-readable error so existing callers behave as before, but callers that care \u2014 billing, in particular \u2014 can tell a failure from real page content." } }, "required": ["text", "html"] } }] }, "screenshot": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["content"] }
+    usageNotes: '- Accepts a single URL or multiple URLs (as a JSON array, comma-separated, or newline-separated).\n- Output format controls the result shape: "text" returns markdown, "html" returns raw HTML, "json" returns structured scraper data, "summary" returns a model-written summary and requires the "firecrawl" service.\n- Can optionally capture a screenshot of each page.\n- Handles bot protection automatically; no proxy or rendering configuration is needed.',
+    inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "URL(s) to scrape. Accepts a single URL, JSON array, or comma/newline-separated list" }, "service": { "enum": ["default", "firecrawl"], "type": "string", "description": "Scraping service to use" }, "autoEnhance": { "type": "boolean", "description": "No longer selects a provider \u2014 the default service's anti-bot engine decides per request how hard to work. Retained because existing workflows set it and the builder still renders it." }, "outputFormat": { "enum": ["text", "json", "html", "summary"], "type": "string", "description": "Output format: text returns markdown, html returns raw HTML, json returns structured scraper data, summary returns a model-written summary (Firecrawl only)" }, "pageOptions": { "type": "object", "properties": { "onlyMainContent": { "type": "boolean", "description": "Whether to extract only the main content of the page, excluding navigation, footers, etc." }, "screenshot": { "type": "boolean", "description": "Whether to capture a screenshot of the page" }, "waitFor": { "type": "number", "description": "Milliseconds to wait before scraping (0 for immediate)" }, "replaceAllPathsWithAbsolutePaths": { "type": "boolean", "description": "Whether to convert relative URLs to absolute URLs in the result" }, "headers": { "type": "object", "properties": {}, "required": [], "description": "Custom HTTP request headers as key-value pairs" }, "removeTags": { "type": "array", "items": { "type": "string" }, "description": "HTML tags to remove from the scraped result" }, "mobile": { "type": "boolean", "description": "Whether to scrape using a mobile user-agent" } }, "required": ["onlyMainContent", "screenshot", "waitFor", "replaceAllPathsWithAbsolutePaths", "headers", "removeTags", "mobile"], "description": "Page-level scraping options (content filtering, screenshots, headers, etc.)" } }, "required": ["url"] },
+    outputSchema: { "type": "object", "properties": { "content": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }, { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "properties": {}, "required": [], "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"], "description": "Set when the scrape failed. `text`/`html` still carry the human-readable error so existing callers behave as before, but callers that care \u2014 billing, in particular \u2014 can tell a failure from real page content." }, "costUnits": { "type": "number", "description": "What the provider actually charged, when it tells us. Scrapfly returns an exact per-request credit total that varies with how hard the target fought back (6 for an unprotected page, 80 for Glassdoor), so billing a flat rate would either overcharge the easy case or eat the hard one. Providers that report nothing leave this undefined and fall back to the route's estimate.\n\nIncludes every attempt made on the caller's behalf, not just the last one." } }, "required": ["text", "html"] }, { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "properties": {}, "required": [], "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"], "description": "Set when the scrape failed. `text`/`html` still carry the human-readable error so existing callers behave as before, but callers that care \u2014 billing, in particular \u2014 can tell a failure from real page content." }, "costUnits": { "type": "number", "description": "What the provider actually charged, when it tells us. Scrapfly returns an exact per-request credit total that varies with how hard the target fought back (6 for an unprotected page, 80 for Glassdoor), so billing a flat rate would either overcharge the easy case or eat the hard one. Providers that report nothing leave this undefined and fall back to the route's estimate.\n\nIncludes every attempt made on the caller's behalf, not just the last one." } }, "required": ["text", "html"] } }] }, "screenshot": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["content"] }
   },
   "scrapeXPost": {
     stepType: "scrapeXPost",
     description: "Scrape data from a single X (Twitter) post by URL.",
     usageNotes: "- Returns structured post data (text, html, optional json/screenshot/metadata).\n- Optionally saves the text content to a variable.",
     inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "Full URL to the X post (e.g. https://x.com/elonmusk/status/1655608985058267139)" } }, "required": ["url"] },
-    outputSchema: { "type": "object", "properties": { "post": { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "properties": {}, "required": [], "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"], "description": "Set when the scrape failed. `text`/`html` still carry the human-readable error so existing callers behave as before, but callers that care \u2014 billing, in particular \u2014 can tell a failure from real page content." } }, "required": ["text", "html"], "description": "Scraped post data including text, HTML, and optional structured JSON" } }, "required": ["post"] }
+    outputSchema: { "type": "object", "properties": { "post": { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "properties": {}, "required": [], "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"], "description": "Set when the scrape failed. `text`/`html` still carry the human-readable error so existing callers behave as before, but callers that care \u2014 billing, in particular \u2014 can tell a failure from real page content." }, "costUnits": { "type": "number", "description": "What the provider actually charged, when it tells us. Scrapfly returns an exact per-request credit total that varies with how hard the target fought back (6 for an unprotected page, 80 for Glassdoor), so billing a flat rate would either overcharge the easy case or eat the hard one. Providers that report nothing leave this undefined and fall back to the route's estimate.\n\nIncludes every attempt made on the caller's behalf, not just the last one." } }, "required": ["text", "html"], "description": "Scraped post data including text, HTML, and optional structured JSON" } }, "required": ["post"] }
   },
   "scrapeXProfile": {
     stepType: "scrapeXProfile",
     description: "Scrape public profile data from an X (Twitter) account by URL.",
     usageNotes: "- Returns structured profile data.\n- Optionally saves the result to a variable.",
     inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "Full URL or username for the X profile (e.g. https://x.com/elonmusk)" } }, "required": ["url"] },
-    outputSchema: { "type": "object", "properties": { "profile": { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "properties": {}, "required": [], "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"], "description": "Set when the scrape failed. `text`/`html` still carry the human-readable error so existing callers behave as before, but callers that care \u2014 billing, in particular \u2014 can tell a failure from real page content." } }, "required": ["text", "html"], "description": "Scraped profile data including text, HTML, and optional structured JSON" } }, "required": ["profile"] }
+    outputSchema: { "type": "object", "properties": { "profile": { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "properties": {}, "required": [], "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": ["code", "message"], "description": "Set when the scrape failed. `text`/`html` still carry the human-readable error so existing callers behave as before, but callers that care \u2014 billing, in particular \u2014 can tell a failure from real page content." }, "costUnits": { "type": "number", "description": "What the provider actually charged, when it tells us. Scrapfly returns an exact per-request credit total that varies with how hard the target fought back (6 for an unprotected page, 80 for Glassdoor), so billing a flat rate would either overcharge the easy case or eat the hard one. Providers that report nothing leave this undefined and fall back to the route's estimate.\n\nIncludes every attempt made on the caller's behalf, not just the last one." } }, "required": ["text", "html"], "description": "Scraped profile data including text, HTML, and optional structured JSON" } }, "required": ["profile"] }
   },
   "screenshotUrl": {
     stepType: "screenshotUrl",
     description: "Capture a screenshot of a web page as a PNG image.",
-    usageNotes: "- Takes a viewport or full-page screenshot of the given URL.\n- Returns a CDN-hosted PNG image URL.\n- Viewport mode captures only the visible area; fullPage captures the entire scrollable page.\n- You can customize viewport width/height, add a delay, or wait for a CSS selector before capturing.",
+    usageNotes: "- Takes a viewport or full-page screenshot of the given URL.\n- Returns a CDN-hosted PNG image URL.\n- Viewport mode captures only the visible area; fullPage captures the entire scrollable page, scrolling it first so lazy-loaded content is included.\n- Works on sites behind bot protection (Cloudflare and similar).\n- Cookie-consent banners and similar overlays are suppressed automatically.\n- `width` and `height` are the exact output pixel dimensions.\n- You can add a delay or wait for a CSS selector before capturing. A selector that never appears fails the step rather than capturing early.",
     inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "URL to screenshot" }, "mode": { "enum": ["viewport", "fullPage"], "type": "string", "description": "Screenshot mode: viewport captures visible area, fullPage captures entire page" }, "width": { "type": "number", "description": "Viewport width in pixels (default: 1280)" }, "height": { "type": "number", "description": "Viewport height in pixels (default: 800, ignored for fullPage mode)" }, "delay": { "type": "number", "description": "Milliseconds to wait before capturing (default: 0)" }, "waitFor": { "type": "string", "description": "CSS selector to wait for before capturing" } }, "required": ["url"] },
     outputSchema: { "type": "object", "properties": { "screenshotUrl": { "type": "string" } }, "required": ["screenshotUrl"] }
   },
@@ -3747,6 +3753,7 @@ function logTaskResult(result) {
   );
 }
 async function runTaskPoll(httpConfig, body) {
+  const traceId = randomUUID2();
   const { data } = await request(
     httpConfig,
     "POST",
@@ -3805,13 +3812,15 @@ async function runTaskPoll(httpConfig, body) {
         outputTokens: 0,
         totalBillingCost: 0
       },
-      toolCalls: poll.toolCalls ?? []
+      toolCalls: poll.toolCalls ?? [],
+      traceId
     };
     logTaskResult(result);
     return result;
   }
 }
 async function runTaskStream(httpConfig, body, onEvent) {
+  const traceId = randomUUID2();
   const url = `${httpConfig.baseUrl}/developer/v2/task`;
   const res = await fetch(url, {
     method: "POST",
@@ -3876,7 +3885,8 @@ async function runTaskStream(httpConfig, body, onEvent) {
               outputTokens: 0,
               totalBillingCost: 0
             },
-            toolCalls: event.toolCalls ?? []
+            toolCalls: event.toolCalls ?? [],
+            traceId
           };
         }
       } catch (err) {
@@ -3906,7 +3916,8 @@ async function runTaskStream(httpConfig, body, onEvent) {
             outputTokens: 0,
             totalBillingCost: 0
           },
-          toolCalls: event.toolCalls ?? []
+          toolCalls: event.toolCalls ?? [],
+          traceId
         };
       }
     } catch (err) {
@@ -3925,6 +3936,7 @@ async function runTaskStream(httpConfig, body, onEvent) {
 }
 
 // src/task/local.ts
+import { randomUUID as randomUUID3 } from "crypto";
 var DEFAULT_MAX_TURNS = 20;
 var MAX_TURNS_LIMIT = 100;
 var MAX_SCHEMA_REPAIR_ATTEMPTS = 3;
@@ -4156,6 +4168,7 @@ ${structuredOutputExample}
     Math.max(options.maxTurns || DEFAULT_MAX_TURNS, 1),
     MAX_TURNS_LIMIT
   );
+  const traceId = randomUUID3();
   const messages = [
     { role: "user", content: JSON.stringify(options.input) }
   ];
@@ -4175,7 +4188,8 @@ ${structuredOutputExample}
     parsedSuccessfully: parsedSuccessfully2,
     turns,
     usage: totalUsage,
-    toolCalls: toolCallLog
+    toolCalls: toolCallLog,
+    traceId
   });
   const accumulate = (turn) => {
     totalUsage.inputTokens += turn.usage.inputTokens ?? 0;
@@ -4243,7 +4257,8 @@ ${structuredOutputExample}
         model: options.model,
         system,
         messages,
-        tools: wireTools
+        tools: wireTools,
+        traceId
       });
     } catch (err) {
       if (loopCount === 1 && err instanceof TurnError && err.status === 404 && err.errorCode === "not_found") {
@@ -4355,7 +4370,8 @@ ${formatValidationErrors(errors)}`
       model: options.model,
       system,
       messages,
-      tools: []
+      tools: [],
+      traceId
     });
     accumulate(turn);
     finalText = turn.text;
@@ -5958,6 +5974,79 @@ var MindStudioAgent = class {
   get files() {
     return this._files ??= createFiles(this._filesRequest.bind(this));
   }
+  /**
+   * Jewel surfaces: arrival-shaped triggers (`propose`) and the app-native
+   * approval queue (`queue.list` / `queue.resolve`). See {@link JewelsApi}.
+   */
+  get jewels() {
+    return {
+      propose: (methodId, subject, opts) => {
+        if (!methodId || typeof methodId !== "string") {
+          throw new MindStudioError(
+            "methodId is required",
+            "missing_method_id",
+            400
+          );
+        }
+        return this._jewelsRequest("propose", {
+          methodId,
+          subject,
+          ...opts?.idempotencyKey !== void 0 && {
+            idempotencyKey: opts.idempotencyKey
+          }
+        });
+      },
+      queue: {
+        list: (opts) => this._jewelsRequest("queue/list", {
+          ...opts?.methodId !== void 0 && { methodId: opts.methodId },
+          ...opts?.limit !== void 0 && { limit: opts.limit }
+        }),
+        resolve: (itemId, opts) => this._jewelsRequest("queue/resolve", {
+          itemId,
+          action: opts.action,
+          ...opts.input !== void 0 && { input: opts.input }
+        })
+      }
+    };
+  }
+  /**
+   * Raw hook-token call shared by the jewels surfaces (mirrors reportIssue).
+   * No retries: propose holds the request for the jewel run and is idempotent
+   * by key anyway; resolve applies a method and must never double-fire.
+   */
+  async _jewelsRequest(path, body) {
+    const rctx = getRequestContext();
+    if (this._authType !== "internal" && !rctx?.callbackToken) {
+      throw new MindStudioError(
+        `jewels.${path.replace("/", ".")} requires an app execution context (hook token) \u2014 it cannot be called with an API key.`,
+        "jewels_requires_app_context",
+        400
+      );
+    }
+    const url = `${this._currentHttpConfig.baseUrl}/_internal/v2/jewels/${path}`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: this._token
+      },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      let code = "jewels_error";
+      let message = `jewels.${path.replace("/", ".")} failed: ${res.status} ${res.statusText}`;
+      let details;
+      try {
+        const errBody = await res.json();
+        details = errBody;
+        if (typeof errBody.errorString === "string") code = errBody.errorString;
+        message = typeof errBody.errorMessage === "string" && errBody.errorMessage || typeof errBody.errorString === "string" && errBody.errorString || message;
+      } catch {
+      }
+      throw new MindStudioError(message, code, res.status, details);
+    }
+    return await res.json();
+  }
   /**
    * Searchable document corpora.
    *
@@ -6519,6 +6608,138 @@ function resolveToken(provided, config) {
   );
 }
 
+// src/jewel/index.ts
+function errorInfo(e) {
+  if (e instanceof Error) return { message: e.message, stack: e.stack };
+  return { message: String(e) };
+}
+function deepEqual(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null || typeof a !== "object" || typeof b !== "object") {
+    return false;
+  }
+  const aIsArray = Array.isArray(a);
+  if (aIsArray !== Array.isArray(b)) return false;
+  if (aIsArray) {
+    const aa = a;
+    const ba = b;
+    return aa.length === ba.length && aa.every((v, i) => deepEqual(v, ba[i]));
+  }
+  const ao = a;
+  const bo = b;
+  const aKeys = Object.keys(ao).filter((k) => ao[k] !== void 0);
+  const bKeys = Object.keys(bo).filter((k) => bo[k] !== void 0);
+  if (aKeys.length !== bKeys.length) return false;
+  return aKeys.every((k) => deepEqual(ao[k], bo[k]));
+}
+var VERDICTS = /* @__PURE__ */ new Set(["agree", "disagree", "skip"]);
+function normalizeVerdict(v) {
+  if (!v || !VERDICTS.has(v.verdict)) {
+    return {
+      verdict: "skip",
+      notes: `grade returned invalid verdict: ${JSON.stringify(v)}`
+    };
+  }
+  return v.notes === void 0 ? { verdict: v.verdict } : { verdict: v.verdict, notes: v.notes };
+}
+function defineJewel(method, config) {
+  const runGrade = async (proposed, actual) => {
+    if (config.grade) {
+      try {
+        return normalizeVerdict(await config.grade({ proposed, actual }));
+      } catch (e) {
+        return { verdict: "skip", notes: `grade threw: ${errorInfo(e).message}` };
+      }
+    }
+    return deepEqual(proposed, actual) ? { verdict: "agree" } : { verdict: "disagree" };
+  };
+  const run = async (params) => {
+    const startedAt = Date.now();
+    const customGrade = config.grade !== void 0;
+    const done = (rest) => ({
+      v: 1,
+      customGrade,
+      startedAt,
+      durationMs: Date.now() - startedAt,
+      ...rest
+    });
+    const traceIds = (t) => {
+      if (t === void 0) return void 0;
+      const ids = (Array.isArray(t) ? t : [t]).filter(
+        (id) => typeof id === "string" && id.length > 0
+      );
+      return ids.length > 0 ? ids : void 0;
+    };
+    if (Object.prototype.hasOwnProperty.call(params, "grade")) {
+      const ctx = params.grade;
+      const verdict2 = await runGrade(ctx.proposed, ctx.actual);
+      const gradeTrace2 = traceIds(verdict2.trace);
+      return done({
+        mode: "grade",
+        proposed: ctx.proposed,
+        actual: ctx.actual,
+        verdict: verdict2.verdict,
+        ...verdict2.notes !== void 0 ? { notes: verdict2.notes } : {},
+        ...gradeTrace2 ? { gradeTrace: gradeTrace2 } : {}
+      });
+    }
+    const isShadow = Object.prototype.hasOwnProperty.call(params, "humanInput");
+    const mode = isShadow ? "shadow" : "eval";
+    const actual = isShadow ? params.humanInput : void 0;
+    let subject;
+    if (isShadow) {
+      try {
+        subject = config.subject(actual);
+      } catch (e) {
+        return done({ mode, actual, error: { phase: "subject", ...errorInfo(e) } });
+      }
+    } else {
+      subject = params.subject;
+    }
+    let proposal;
+    try {
+      proposal = await config.propose(subject);
+    } catch (e) {
+      return done({
+        mode,
+        subject,
+        actual,
+        error: { phase: "propose", ...errorInfo(e) }
+      });
+    }
+    const trace = traceIds(proposal.trace);
+    if (!isShadow) {
+      return done({
+        mode,
+        subject,
+        proposed: proposal.input,
+        reasoning: proposal.reasoning,
+        ...trace ? { trace } : {}
+      });
+    }
+    const verdict = await runGrade(proposal.input, actual);
+    const gradeTrace = traceIds(verdict.trace);
+    return done({
+      mode,
+      subject,
+      proposed: proposal.input,
+      reasoning: proposal.reasoning,
+      actual,
+      verdict: verdict.verdict,
+      ...verdict.notes !== void 0 ? { notes: verdict.notes } : {},
+      ...trace ? { trace } : {},
+      ...gradeTrace ? { gradeTrace } : {}
+    });
+  };
+  return Object.assign(run, {
+    kind: "jewel",
+    method,
+    subject: config.subject,
+    propose: config.propose,
+    grade: config.grade
+  });
+}
+
 // src/generated/snippets.ts
 var monacoSnippets = {
   "activeCampaignAddNote": { fields: [["contactId", "string"], ["note", "string"]], outputKeys: [] },
@@ -6770,6 +6991,7 @@ export {
   dataSources,
   db,
   index_default as default,
+  defineJewel,
   files,
   getRequestContext,
   mindstudio,