@mindstudio-ai/agent 0.1.48 → 0.1.50

package/dist/index.d.ts

@@ -1213,12 +1213,16 @@ interface RunTaskResult<T = unknown> {
 /**
  * Client for the MindStudio direct step execution API.
  *
- * Create an instance and call typed step methods directly:
+ * Inside MindStudio apps, use the `mindstudio` singleton (auth is automatic):
+ * ```ts
+ * import { mindstudio } from '@mindstudio-ai/agent';
+ * const { imageUrl } = await mindstudio.generateImage({ prompt: "a sunset" });
+ * ```
  *
+ * For external usage with an API key:
  * ```ts
  * const agent = new MindStudioAgent({ apiKey: "your-key" });
- * const { imageUrl } = await agent.generateImage({ prompt: "a sunset", mode: "background" });
- * console.log(imageUrl);
+ * const { imageUrl } = await agent.generateImage({ prompt: "a sunset" });
  * ```
  *
  * Authentication is resolved in order:
@@ -6035,10 +6039,11 @@ interface StepMethods {
      */
     extractAudioFromVideo(step: ExtractAudioFromVideoStepInput, options?: StepExecutionOptions): Promise<StepExecutionResult<ExtractAudioFromVideoStepOutput>>;
     /**
-     * Download a file from a URL and extract its text content. Supports PDFs, plain text files, and other document formats.
+     * Download a file from a URL and extract its text content. Supports PDFs (including scanned/image-based PDFs via OCR), plain text files, and other document formats.
      *
      * @remarks
      * - Best suited for PDFs and raw text/document files. For web pages, use the scrapeUrl step instead.
+     * - Handles both text-layer PDFs and image-based/scanned PDFs (e.g. Figma/Canva exports, scanned documents). Image-based PDFs are processed with OCR automatically — there is no need to convert PDF pages to images first.
      * - Accepts a single URL, a comma-separated list of URLs, or a JSON array of URLs.
      * - Files are rehosted on the MindStudio CDN before extraction.
      * - Maximum file size is 50MB per URL.

package/dist/index.js

@@ -1,3 +1,10 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
 // src/errors.ts
 var MindStudioError = class extends Error {
   constructor(message, code, status, details) {
@@ -81,13 +88,26 @@ function sleep(ms) {
 }
 
 // src/context.ts
-import { AsyncLocalStorage } from "async_hooks";
-var als = new AsyncLocalStorage();
+var als;
+function getAls() {
+  if (!als) {
+    try {
+      const { AsyncLocalStorage } = __require("async_hooks");
+      als = new AsyncLocalStorage();
+    } catch {
+      als = {
+        getStore: () => void 0,
+        run: (_store, fn) => fn()
+      };
+    }
+  }
+  return als;
+}
 function getRequestContext() {
-  return als.getStore();
+  return getAls().getStore();
 }
 function runWithContext(ctx, fn) {
-  return als.run(ctx, fn);
+  return getAls().run(ctx, fn);
 }
 
 // src/rate-limit.ts
@@ -1959,8 +1979,8 @@ var stepMetadata = {
   },
   "extractText": {
     stepType: "extractText",
-    description: "Download a file from a URL and extract its text content. Supports PDFs, plain text files, and other document formats.",
-    usageNotes: "- Best suited for PDFs and raw text/document files. For web pages, use the scrapeUrl step instead.\n- Accepts a single URL, a comma-separated list of URLs, or a JSON array of URLs.\n- Files are rehosted on the MindStudio CDN before extraction.\n- Maximum file size is 50MB per URL.",
+    description: "Download a file from a URL and extract its text content. Supports PDFs (including scanned/image-based PDFs via OCR), plain text files, and other document formats.",
+    usageNotes: "- Best suited for PDFs and raw text/document files. For web pages, use the scrapeUrl step instead.\n- Handles both text-layer PDFs and image-based/scanned PDFs (e.g. Figma/Canva exports, scanned documents). Image-based PDFs are processed with OCR automatically \u2014 there is no need to convert PDF pages to images first.\n- Accepts a single URL, a comma-separated list of URLs, or a JSON array of URLs.\n- Files are rehosted on the MindStudio CDN before extraction.\n- Maximum file size is 50MB per URL.",
     inputSchema: { "type": "object", "properties": { "url": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["url"] },
     outputSchema: { "type": "object", "properties": { "text": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["text"] }
   },