@dealcrawl/sdk 2.3.0 → 2.4.0

package/dist/index.mjs

@@ -780,6 +780,65 @@ var AgentResource = class {
       ...options
     });
   }
+  /**
+   * Generate a JSON Schema from a natural language prompt
+   *
+   * This is useful for building extraction schemas without manual JSON writing.
+   * The generated schema can be used with the main agent.create() method.
+   *
+   * @param options - Schema generation options
+   * @returns Generated schema with refined prompt and confidence score
+   *
+   * @example Basic usage:
+   * ```ts
+   * const result = await client.agent.generateSchema({
+   *   prompt: "Find the best student deals on Coursera for marketing courses"
+   * });
+   *
+   * console.log(result.schema);
+   * // { type: "object", properties: { courses: { ... } } }
+   *
+   * console.log(result.refinedPrompt);
+   * // "Extract student offers for marketing courses..."
+   *
+   * // Use the generated schema with an agent
+   * const job = await client.agent.create({
+   *   url: "https://coursera.org",
+   *   prompt: result.refinedPrompt,
+   *   schema: result.schema
+   * });
+   * ```
+   *
+   * @example With context from conversation:
+   * ```ts
+   * const result = await client.agent.generateSchema({
+   *   prompt: "Find student deals on online courses",
+   *   context: {
+   *     domains: ["marketing", "web development"],
+   *     dataTypes: ["free courses", "discounts"],
+   *     format: "json"
+   *   }
+   * });
+   *
+   * if (result.confidence < 0.7 && result.suggestedQuestions) {
+   *   // Ask user for clarification
+   *   console.log("Please clarify:", result.suggestedQuestions);
+   * }
+   * ```
+   */
+  async generateSchema(options) {
+    const body = {
+      prompt: options.prompt,
+      context: options.context,
+      model: options.model ?? "openai"
+    };
+    const result = await post(
+      this.ctx,
+      "/v1/agent/schema",
+      body
+    );
+    return result.data;
+  }
 };
 
 // src/resources/crawl.ts