@expandai/mcp-server 0.1.4 → 0.2.0

package/dist/Server.cjs

@@ -40,7 +40,7 @@ var S__namespace = /*#__PURE__*/_interopNamespace(S);
 
 // package.json
 var package_default = {
-  version: "0.1.4"};
+  version: "0.2.0"};
 var ExpandDocs = ai.McpServer.resource({
   uri: "expand://about",
   name: "About expand.ai",
@@ -104,10 +104,14 @@ var HttpApiDecodeError = class extends S__namespace.Class("HttpApiDecodeError")(
   _tag: HttpApiDecodeErrorTag
 }) {
 };
-var UnauthorizedAccessTag = class extends S__namespace.Literal("UnauthorizedAccess") {
+var AuthFailedReason = class extends S__namespace.Literal("InvalidApiKey", "InvalidToken", "InvalidSession", "InvalidTenant") {
 };
-var UnauthorizedAccess = class extends S__namespace.Class("UnauthorizedAccess")({
-  _tag: UnauthorizedAccessTag
+var AuthFailedTag = class extends S__namespace.Literal("AuthFailed") {
+};
+var AuthFailed = class extends S__namespace.Class("AuthFailed")({
+  reason: AuthFailedReason,
+  description: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
+  _tag: AuthFailedTag
 }) {
 };
 var AssetNotFoundTag = class extends S__namespace.Literal("AssetNotFound") {
@@ -150,7 +154,13 @@ var AssetRetrievalError = class extends S__namespace.Class("AssetRetrievalError"
   _tag: AssetRetrievalErrorTag
 }) {
 };
-var AssetsGetByUrl500 = class extends S__namespace.Union(AssetReadError, InvalidWaczFormat, AssetRetrievalError) {
+var InternalErrorTag = class extends S__namespace.Literal("InternalError") {
+};
+var InternalError = class extends S__namespace.Class("InternalError")({
+  _tag: InternalErrorTag
+}) {
+};
+var AssetsGetByUrl500 = class extends S__namespace.Union(InternalError, AssetReadError, InvalidWaczFormat, AssetRetrievalError) {
 };
 var CurlErrorInputMethod = class extends S__namespace.Literal(
   "GET",
@@ -164,6 +174,8 @@ var CurlErrorInputMethod = class extends S__namespace.Literal(
   "PATCH"
 ) {
 };
+var URL = class extends S__namespace.String {
+};
 var CurlErrorTag = class extends S__namespace.Literal("CurlError") {
 };
 var CurlError = class extends S__namespace.Class("CurlError")({
@@ -174,11 +186,14 @@ var CurlError = class extends S__namespace.Class("CurlError")({
     body: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
     headers: S__namespace.optionalWith(S__namespace.Struct({}), { nullable: true }),
     proxy: S__namespace.optionalWith(
-      S__namespace.Struct({
-        server: S__namespace.String,
-        username: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
-        password: S__namespace.optionalWith(S__namespace.String, { nullable: true })
-      }),
+      S__namespace.Union(
+        S__namespace.Struct({
+          server: S__namespace.String,
+          username: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
+          password: S__namespace.optionalWith(S__namespace.String, { nullable: true })
+        }),
+        URL
+      ),
       { nullable: true }
     ),
     timeout: S__namespace.optionalWith(S__namespace.Number, { nullable: true }),
@@ -198,9 +213,20 @@ var AssetListResponse = class extends S__namespace.Class("AssetListResponse")({
   assets: S__namespace.Array(AssetListItem)
 }) {
 };
-var AssetsList500 = class extends S__namespace.Union(AssetReadError, InvalidWaczFormat) {
+var AssetsList500 = class extends S__namespace.Union(InternalError, AssetReadError, InvalidWaczFormat) {
 };
-var URL = class extends S__namespace.String {
+var AssetsGetWacz500 = class extends S__namespace.Union(InternalError, AssetReadError) {
+};
+var DatasetNotFoundTag = class extends S__namespace.Literal("DatasetNotFound") {
+};
+var DatasetNotFound = class extends S__namespace.Class("DatasetNotFound")({
+  path: S__namespace.String,
+  _tag: DatasetNotFoundTag
+}) {
+};
+var DatasetsGetDataset500 = class extends S__namespace.Union(InternalError, DatasetNotFound) {
+};
+var DatasetsGetFinetuneDataset500 = class extends S__namespace.Union(InternalError, DatasetNotFound) {
 };
 var SelectHtmlConfig = class extends S__namespace.Record({ key: S__namespace.String, value: S__namespace.Unknown }) {
 };
@@ -293,6 +319,29 @@ var Int2 = class extends S__namespace.Int {
         }),
         { nullable: true }
       ),
+      links: S__namespace.optionalWith(
+        S__namespace.Union(
+          S__namespace.Boolean,
+          /**
+           * Options for customizing link extraction from the page
+           */
+          S__namespace.Struct({
+            /**
+             * Only include links from the same domain as the fetched URL
+             */
+            sameDomainOnly: S__namespace.optionalWith(S__namespace.Boolean, { nullable: true, default: () => true }),
+            /**
+             * Regex patterns - only include links matching at least one pattern
+             */
+            includePatterns: S__namespace.optionalWith(S__namespace.Array(S__namespace.String), { nullable: true }),
+            /**
+             * Regex patterns - exclude links matching any pattern
+             */
+            excludePatterns: S__namespace.optionalWith(S__namespace.Array(S__namespace.String), { nullable: true })
+          })
+        ),
+        { nullable: true }
+      ),
       /**
        * Include page metadata in the response
        */
@@ -308,7 +357,15 @@ var Int2 = class extends S__namespace.Int {
           includeHeaders: S__namespace.optionalWith(S__namespace.Boolean, { nullable: true, default: () => false })
         }),
         { nullable: true }
-      )
+      ),
+      /**
+       * Include pruned JSON in the response (opt-in)
+       */
+      json: S__namespace.optionalWith(S__namespace.Boolean, { nullable: true, default: () => false }),
+      /**
+       * Set to true to include extracted links and sidebar content
+       */
+      appendix: S__namespace.optionalWith(S__namespace.Boolean, { nullable: true })
     }),
     { nullable: true }
   ),
@@ -476,58 +533,75 @@ var PageMeta = class extends S__namespace.Class("PageMeta")({
   twitter: S__namespace.optionalWith(TwitterCardMeta, { nullable: true })
 }) {
 };
-var FetchData = class extends S__namespace.Class("FetchData")({
-  response: ResponseInfo,
-  /**
-   * Page metadata extracted from HTML head (title, description, Open Graph, Twitter Card, icons)
-   */
-  meta: S__namespace.optionalWith(PageMeta, { nullable: true }),
+var FetchLink = class extends S__namespace.Class("FetchLink")({
   /**
-   * The HTML content of the fetched page
+   * The URL of the link
    */
-  html: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
-  /**
-   * The markdown-formatted content extracted from the page
-   */
-  markdown: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
-  /**
-   * Base64-encoded data URI of the screenshot image
-   */
-  screenshot: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
-  /**
-   * AI-generated summary of the page content
-   */
-  summary: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
+  url: S__namespace.String,
   /**
-   * Relevant snippets extracted from the page based on the search query
+   * The anchor text of the link
    */
-  snippets: S__namespace.optionalWith(
-    S__namespace.Array(
-      S__namespace.Struct({
-        /**
-         * Type identifier for TextPart compatibility
-         */
-        type: S__namespace.optionalWith(S__namespace.Literal("text"), { nullable: true, default: () => "text" }),
-        /**
-         * The text content of the snippet
-         */
-        text: S__namespace.String,
-        /**
-         * Relevance score from the reranker (0-1)
-         */
-        score: S__namespace.Number,
-        /**
-         * Original chunk index
-         */
-        index: S__namespace.Number
-      })
-    ),
-    { nullable: true }
-  )
+  text: S__namespace.optionalWith(S__namespace.String, { nullable: true })
 }) {
 };
 var FetchResult = class extends S__namespace.Class("FetchResult")({
-  data: FetchData
+  /**
+   * Contains the extracted content in the formats specified by the select configuration
+   */
+  data: S__namespace.Struct({
+    response: ResponseInfo,
+    meta: S__namespace.optionalWith(PageMeta, { nullable: true }),
+    /**
+     * The HTML content of the fetched page
+     */
+    html: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
+    /**
+     * The markdown-formatted content extracted from the page
+     */
+    markdown: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
+    /**
+     * Base64-encoded data URI of the screenshot image
+     */
+    screenshot: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
+    /**
+     * AI-generated summary of the page content
+     */
+    summary: S__namespace.optionalWith(S__namespace.String, { nullable: true }),
+    /**
+     * Relevant snippets extracted from the page based on the search query
+     */
+    snippets: S__namespace.optionalWith(
+      S__namespace.Array(
+        S__namespace.Struct({
+          /**
+           * Type identifier for TextPart compatibility
+           */
+          type: S__namespace.optionalWith(S__namespace.Literal("text"), { nullable: true, default: () => "text" }),
+          /**
+           * The text content of the snippet
+           */
+          text: S__namespace.String,
+          /**
+           * Relevance score from the reranker (0-1)
+           */
+          score: S__namespace.Number,
+          /**
+           * Original chunk index
+           */
+          index: S__namespace.Number
+        })
+      ),
+      { nullable: true }
+    ),
+    /**
+     * Links extracted from the page
+     */
+    links: S__namespace.optionalWith(S__namespace.Array(FetchLink), { nullable: true }),
+    /**
+     * Extracted links and sidebar content
+     */
+    appendix: S__namespace.optionalWith(S__namespace.String, { nullable: true })
+  })
 }) {
 };
 var FetchErrorTag = class extends S__namespace.Literal("FetchError") {
@@ -536,25 +610,8 @@ var FetchError = class extends S__namespace.Class("FetchError")({
   _tag: FetchErrorTag
 }) {
 };
-(class extends S__namespace.Class("MarkdownRequest")({
-  /**
-   * The URL to fetch markdown content from
-   */
-  url: S__namespace.String,
-  /**
-   * Configuration options for browser behavior during the fetch
-   */
-  browserConfig: S__namespace.optionalWith(
-    S__namespace.Struct({
-      /**
-       * Whether to scroll the entire page to capture lazy-loaded content
-       */
-      scrollFullPage: S__namespace.optionalWith(S__namespace.Boolean, { nullable: true, default: () => false })
-    }),
-    { nullable: true }
-  )
-}) {
-});
+var Fetch500 = class extends S__namespace.Union(InternalError, FetchError) {
+};
 var InvalidAssetHashTag = class extends S__namespace.Literal("InvalidAssetHash") {
 };
 var InvalidAssetHash = class extends S__namespace.Class("InvalidAssetHash")({
@@ -586,12 +643,223 @@ var AssetFetchError = class extends S__namespace.Class("AssetFetchError")({
 }) {
 };
 var LocalAssetsGetAsset500 = class extends S__namespace.Union(
+  InternalError,
   InvalidAssetHash,
   AssetNotFoundInHar,
   HarNotFound,
   AssetFetchError
 ) {
 };
+(class extends S__namespace.Class("PlaygroundFetchRequest")({
+  url: URL,
+  /**
+   * Specifies which content formats to include in the response
+   */
+  select: S__namespace.optionalWith(
+    S__namespace.Struct({
+      html: S__namespace.optionalWith(
+        S__namespace.Union(
+          S__namespace.Boolean,
+          SelectHtmlConfig
+        ),
+        { nullable: true }
+      ),
+      /**
+       * Include markdown-formatted content in the response
+       */
+      markdown: S__namespace.optionalWith(
+        S__namespace.Union(
+          S__namespace.Boolean,
+          SelectMarkdownConfig
+        ),
+        { nullable: true }
+      ),
+      screenshot: S__namespace.optionalWith(
+        S__namespace.Union(
+          S__namespace.Boolean,
+          SelectScreenshotConfig
+        ),
+        { nullable: true }
+      ),
+      summary: S__namespace.optionalWith(
+        S__namespace.Union(
+          S__namespace.Boolean,
+          /**
+           * Options for AI-powered page summarization
+           */
+          S__namespace.Struct({
+            /**
+             * Custom prompt for AI summarization (max 5000 characters)
+             */
+            prompt: S__namespace.optionalWith(S__namespace.String.pipe(S__namespace.maxLength(5e3)), {
+              nullable: true,
+              default: () => "You are a helpful assistant that summarizes web page content.\nGiven the markdown content of a web page, provide a clear and concise summary.\nFocus on the main points and key information.\nKeep the summary informative but brief."
+            })
+          })
+        ),
+        { nullable: true }
+      ),
+      /**
+       * Options for extracting relevant snippets from page content using semantic search
+       */
+      snippets: S__namespace.optionalWith(
+        S__namespace.Struct({
+          /**
+           * Query to find relevant content snippets from the page (required, non-empty)
+           */
+          query: Trimmed,
+          /**
+           * Maximum number of snippets to return (1-50)
+           */
+          maxSnippets: S__namespace.optionalWith(Int2, { nullable: true, default: () => 5 }),
+          /**
+           * Minimum relevance score threshold (0-1). Snippets below this score are filtered out.
+           */
+          minScore: S__namespace.optionalWith(S__namespace.Number.pipe(S__namespace.greaterThanOrEqualTo(0), S__namespace.lessThanOrEqualTo(1)), {
+            nullable: true,
+            default: () => 0.5
+          }),
+          /**
+           * Target snippet size in characters (100-2000)
+           */
+          targetSnippetSize: S__namespace.optionalWith(Int2, { nullable: true, default: () => 384 })
+        }),
+        { nullable: true }
+      ),
+      links: S__namespace.optionalWith(
+        S__namespace.Union(
+          S__namespace.Boolean,
+          /**
+           * Options for customizing link extraction from the page
+           */
+          S__namespace.Struct({
+            /**
+             * Only include links from the same domain as the fetched URL
+             */
+            sameDomainOnly: S__namespace.optionalWith(S__namespace.Boolean, { nullable: true, default: () => true }),
+            /**
+             * Regex patterns - only include links matching at least one pattern
+             */
+            includePatterns: S__namespace.optionalWith(S__namespace.Array(S__namespace.String), { nullable: true }),
+            /**
+             * Regex patterns - exclude links matching any pattern
+             */
+            excludePatterns: S__namespace.optionalWith(S__namespace.Array(S__namespace.String), { nullable: true })
+          })
+        ),
+        { nullable: true }
+      ),
+      /**
+       * Include page metadata in the response
+       */
+      meta: S__namespace.optionalWith(S__namespace.Boolean, { nullable: true, default: () => true }),
+      /**
+       * Configure response info options (headers inclusion)
+       */
+      response: S__namespace.optionalWith(
+        S__namespace.Struct({
+          /**
+           * Whether to include HTTP response headers
+           */
+          includeHeaders: S__namespace.optionalWith(S__namespace.Boolean, { nullable: true, default: () => false })
+        }),
+        { nullable: true }
+      ),
+      /**
+       * Include pruned JSON in the response (opt-in)
+       */
+      json: S__namespace.optionalWith(S__namespace.Boolean, { nullable: true, default: () => false }),
+      /**
+       * Set to true to include extracted links and sidebar content
+       */
+      appendix: S__namespace.optionalWith(S__namespace.Boolean, { nullable: true })
+    }),
+    { nullable: true }
+  ),
+  /**
+   * Configuration options for browser behavior during the fetch
+   */
+  browserConfig: S__namespace.optionalWith(
+    S__namespace.Struct({
+      /**
+       * Whether to scroll the entire page to capture lazy-loaded content
+       */
+      scrollFullPage: S__namespace.optionalWith(S__namespace.Boolean, { nullable: true, default: () => false })
+    }),
+    { nullable: true }
+  )
+}) {
+});
+var PlaygroundData = class extends S__namespace.Class("PlaygroundData")({
+  response: ResponseInfo,
+  /**
+   * HTML with expand-id attributes on elements
+   */
+  html: S__namespace.String,
+  browserSessionId: S__namespace.String
+}) {
+};
+var PlaygroundResult = class extends S__namespace.Class("PlaygroundResult")({
+  data: PlaygroundData
+}) {
+};
+var PlaygroundFetch500 = class extends S__namespace.Union(InternalError, FetchError) {
+};
+var PlaygroundGet500 = class extends S__namespace.Union(InternalError, FetchError) {
+};
+var PlaygroundGetBySession500 = class extends S__namespace.Union(InternalError, FetchError) {
+};
+(class extends S__namespace.Class("PlaygroundSearchRequest")({
+  /**
+   * Search query to find relevant content chunks
+   */
+  query: Trimmed,
+  /**
+   * Browser session ID from the playground fetch result
+   */
+  browserSessionId: S__namespace.String,
+  /**
+   * Maximum number of results to return
+   */
+  maxResults: S__namespace.optionalWith(S__namespace.Number, { nullable: true }),
+  /**
+   * Minimum relevance score threshold (0-1). A value of 0 disables filtering.
+   */
+  minScore: S__namespace.optionalWith(S__namespace.Number, { nullable: true })
+}) {
+});
+var PlaygroundSearchChunk = class extends S__namespace.Class("PlaygroundSearchChunk")({
+  /**
+   * The chunk text content
+   */
+  text: S__namespace.String,
+  /**
+   * Relevance score from 0-1
+   */
+  score: S__namespace.Number,
+  /**
+   * Original chunk index
+   */
+  index: S__namespace.Number,
+  /**
+   * MDAST originalNodeIds for highlighting in HTML/markdown views
+   */
+  nodeIds: S__namespace.Array(S__namespace.Number)
+}) {
+};
+var PlaygroundSearch200 = class extends S__namespace.Struct({
+  /**
+   * Scored and ranked content chunks
+   */
+  chunks: S__namespace.Array(PlaygroundSearchChunk),
+  /**
+   * Duration of the search operation in milliseconds
+   */
+  durationMs: S__namespace.optionalWith(S__namespace.Number, { nullable: true })
+}) {
+};
+var PlaygroundSearch500 = class extends S__namespace.Union(InternalError, FetchError) {
+};
 var make = (httpClient, options = {}) => {
   const unexpectedStatus = (response) => Effect2__namespace.flatMap(
     Effect2__namespace.orElseSucceed(response.json, () => "Unexpected status code"),
@@ -620,49 +888,79 @@ var make = (httpClient, options = {}) => {
       withResponse(
         HttpClientResponse__namespace.matchStatus({
           "400": decodeError("HttpApiDecodeError", HttpApiDecodeError),
-          "401": decodeError("UnauthorizedAccess", UnauthorizedAccess),
+          "401": decodeError("AuthFailed", AuthFailed),
           "404": decodeError("AssetsGetByUrl404", AssetsGetByUrl404),
           "500": decodeError("AssetsGetByUrl500", AssetsGetByUrl500),
           "502": decodeError("CurlError", CurlError),
           "429": () => Effect2__namespace.void,
+          "503": () => Effect2__namespace.void,
           orElse: unexpectedStatus
         })
       )
     ),
-    assetsList: (browserSessionId) => HttpClientRequest__namespace.get(`/v1/assets/${browserSessionId}`).pipe(
+    assetsList: (browserSessionId) => HttpClientRequest__namespace.get(`/v1/assets/${browserSessionId}/list`).pipe(
       withResponse(
         HttpClientResponse__namespace.matchStatus({
           "2xx": decodeSuccess(AssetListResponse),
           "400": decodeError("HttpApiDecodeError", HttpApiDecodeError),
-          "401": decodeError("UnauthorizedAccess", UnauthorizedAccess),
+          "401": decodeError("AuthFailed", AuthFailed),
           "404": decodeError("AssetNotFound", AssetNotFound),
           "500": decodeError("AssetsList500", AssetsList500),
           "429": () => Effect2__namespace.void,
+          "503": () => Effect2__namespace.void,
           orElse: unexpectedStatus
         })
       )
     ),
-    fetch: (options2) => HttpClientRequest__namespace.post(`/v1/fetch`).pipe(
-      HttpClientRequest__namespace.bodyUnsafeJson(options2),
+    assetsGetWacz: (browserSessionId) => HttpClientRequest__namespace.get(`/v1/assets/${browserSessionId}`).pipe(
+      withResponse(
+        HttpClientResponse__namespace.matchStatus({
+          "400": decodeError("HttpApiDecodeError", HttpApiDecodeError),
+          "401": decodeError("AuthFailed", AuthFailed),
+          "404": decodeError("AssetNotFound", AssetNotFound),
+          "500": decodeError("AssetsGetWacz500", AssetsGetWacz500),
+          "429": () => Effect2__namespace.void,
+          "503": () => Effect2__namespace.void,
+          orElse: unexpectedStatus
+        })
+      )
+    ),
+    datasetsGetDataset: () => HttpClientRequest__namespace.get(`/datasets/page-analysis`).pipe(
+      withResponse(
+        HttpClientResponse__namespace.matchStatus({
+          "400": decodeError("HttpApiDecodeError", HttpApiDecodeError),
+          "401": decodeError("AuthFailed", AuthFailed),
+          "500": decodeError("DatasetsGetDataset500", DatasetsGetDataset500),
+          "204": () => Effect2__namespace.void,
+          "429": () => Effect2__namespace.void,
+          "503": () => Effect2__namespace.void,
+          orElse: unexpectedStatus
+        })
+      )
+    ),
+    datasetsGetFinetuneDataset: () => HttpClientRequest__namespace.get(`/datasets/finetune`).pipe(
       withResponse(
         HttpClientResponse__namespace.matchStatus({
-          "2xx": decodeSuccess(FetchResult),
           "400": decodeError("HttpApiDecodeError", HttpApiDecodeError),
-          "401": decodeError("UnauthorizedAccess", UnauthorizedAccess),
-          "500": decodeError("FetchError", FetchError),
+          "401": decodeError("AuthFailed", AuthFailed),
+          "500": decodeError("DatasetsGetFinetuneDataset500", DatasetsGetFinetuneDataset500),
+          "204": () => Effect2__namespace.void,
           "429": () => Effect2__namespace.void,
+          "503": () => Effect2__namespace.void,
           orElse: unexpectedStatus
         })
       )
     ),
-    markdown: (options2) => HttpClientRequest__namespace.post(`/v1/fetch/markdown`).pipe(
+    fetch: (options2) => HttpClientRequest__namespace.post(`/v1/fetch`).pipe(
       HttpClientRequest__namespace.bodyUnsafeJson(options2),
       withResponse(
         HttpClientResponse__namespace.matchStatus({
+          "2xx": decodeSuccess(FetchResult),
           "400": decodeError("HttpApiDecodeError", HttpApiDecodeError),
-          "401": decodeError("UnauthorizedAccess", UnauthorizedAccess),
-          "500": decodeError("FetchError", FetchError),
+          "401": decodeError("AuthFailed", AuthFailed),
+          "500": decodeError("Fetch500", Fetch500),
           "429": () => Effect2__namespace.void,
+          "503": () => Effect2__namespace.void,
           orElse: unexpectedStatus
         })
       )
@@ -671,9 +969,65 @@ var make = (httpClient, options = {}) => {
       withResponse(
         HttpClientResponse__namespace.matchStatus({
           "400": decodeError("HttpApiDecodeError", HttpApiDecodeError),
+          "401": decodeError("AuthFailed", AuthFailed),
           "500": decodeError("LocalAssetsGetAsset500", LocalAssetsGetAsset500),
           "204": () => Effect2__namespace.void,
           "429": () => Effect2__namespace.void,
+          "503": () => Effect2__namespace.void,
+          orElse: unexpectedStatus
+        })
+      )
+    ),
+    playgroundFetch: (options2) => HttpClientRequest__namespace.post(`/v1/playground/fetch`).pipe(
+      HttpClientRequest__namespace.bodyUnsafeJson(options2),
+      withResponse(
+        HttpClientResponse__namespace.matchStatus({
+          "2xx": decodeSuccess(PlaygroundResult),
+          "400": decodeError("HttpApiDecodeError", HttpApiDecodeError),
+          "401": decodeError("AuthFailed", AuthFailed),
+          "500": decodeError("PlaygroundFetch500", PlaygroundFetch500),
+          "429": () => Effect2__namespace.void,
+          "503": () => Effect2__namespace.void,
+          orElse: unexpectedStatus
+        })
+      )
+    ),
+    playgroundGet: (fetchRequestId) => HttpClientRequest__namespace.get(`/v1/playground/get/${fetchRequestId}`).pipe(
+      withResponse(
+        HttpClientResponse__namespace.matchStatus({
+          "2xx": decodeSuccess(PlaygroundResult),
+          "400": decodeError("HttpApiDecodeError", HttpApiDecodeError),
+          "401": decodeError("AuthFailed", AuthFailed),
+          "500": decodeError("PlaygroundGet500", PlaygroundGet500),
+          "429": () => Effect2__namespace.void,
+          "503": () => Effect2__namespace.void,
+          orElse: unexpectedStatus
+        })
+      )
+    ),
+    playgroundGetBySession: (browserSessionId) => HttpClientRequest__namespace.get(`/v1/playground/session/${browserSessionId}`).pipe(
+      withResponse(
+        HttpClientResponse__namespace.matchStatus({
+          "2xx": decodeSuccess(PlaygroundResult),
+          "400": decodeError("HttpApiDecodeError", HttpApiDecodeError),
+          "401": decodeError("AuthFailed", AuthFailed),
+          "500": decodeError("PlaygroundGetBySession500", PlaygroundGetBySession500),
+          "429": () => Effect2__namespace.void,
+          "503": () => Effect2__namespace.void,
+          orElse: unexpectedStatus
+        })
+      )
+    ),
+    playgroundSearch: (options2) => HttpClientRequest__namespace.post(`/v1/playground/search`).pipe(
+      HttpClientRequest__namespace.bodyUnsafeJson(options2),
+      withResponse(
+        HttpClientResponse__namespace.matchStatus({
+          "2xx": decodeSuccess(PlaygroundSearch200),
+          "400": decodeError("HttpApiDecodeError", HttpApiDecodeError),
+          "401": decodeError("AuthFailed", AuthFailed),
+          "500": decodeError("PlaygroundSearch500", PlaygroundSearch500),
+          "429": () => Effect2__namespace.void,
+          "503": () => Effect2__namespace.void,
           orElse: unexpectedStatus
         })
       )
@@ -723,81 +1077,82 @@ var ExpandClient = class extends effect.Effect.Service()("ExpandClient", {
   })
 }) {
 };
-var SnippetsFormat = class extends effect.Schema.Class("SnippetsFormat")({
+var SearchParams = class extends effect.Schema.Class("SearchParams")({
   query: effect.Schema.String.annotations({
-    description: "Query to find relevant content snippets from the page"
+    description: "Query to find relevant content snippets"
   }),
-  maxSnippets: effect.Schema.optional(
-    effect.Schema.Int.pipe(effect.Schema.greaterThanOrEqualTo(1), effect.Schema.lessThanOrEqualTo(50))
-  ).annotations({
-    description: "Maximum number of snippets to return (1-50, default: 5)"
+  minScore: effect.Schema.optionalWith(effect.Schema.Number.pipe(effect.Schema.greaterThanOrEqualTo(0), effect.Schema.lessThanOrEqualTo(1)), {
+    default: () => 0.6
+  }).annotations({
+    description: "Minimum relevance score (0-1)",
+    default: 0.6
   }),
-  targetSnippetSize: effect.Schema.optional(
-    effect.Schema.Int.pipe(effect.Schema.greaterThanOrEqualTo(100), effect.Schema.lessThanOrEqualTo(2e3))
-  ).annotations({
-    description: "Target snippet size in characters (100-2000, default: 384)"
+  maxResults: effect.Schema.optionalWith(effect.Schema.Int.pipe(effect.Schema.greaterThanOrEqualTo(1), effect.Schema.lessThanOrEqualTo(50)), {
+    default: () => 5
+  }).annotations({
+    description: "Maximum snippets to return",
+    default: 5
   })
 }) {
 };
-var Format = effect.Schema.Union(
-  effect.Schema.Literal("markdown").annotations({
-    description: "Return as cleaned markdown content"
-  }),
-  effect.Schema.Literal("html").annotations({
-    description: "Return as raw HTML content"
-  }),
-  effect.Schema.Literal("summary").annotations({
-    description: "Return AI-generated summary of the page content"
-  }),
-  SnippetsFormat
-).annotations({
-  description: "Output format for the fetched content"
-});
 var FetchParams = class extends effect.Schema.Class("FetchParams")({
   url: effect.Schema.String.annotations({
     description: "The URL to fetch content from"
   }),
-  format: Format,
-  includeMeta: effect.Schema.Boolean.annotations({
-    description: "Whether to include page meta tags in the response"
+  includeMeta: effect.Schema.optionalWith(effect.Schema.Boolean, { default: () => false }).annotations({
+    description: "Include page meta tags (title, description, Open Graph)",
+    default: false
+  }),
+  includeAppendix: effect.Schema.optionalWith(effect.Schema.Boolean, { default: () => false }).annotations({
+    description: "Include extracted links and sidebar content",
+    default: false
+  }),
+  includeJson: effect.Schema.optionalWith(effect.Schema.Boolean, { default: () => false }).annotations({
+    description: "Include JSON extracted from network responses and DOM",
+    default: false
+  }),
+  search: effect.Schema.optional(SearchParams).annotations({
+    description: "Semantic search. When provided, returns snippets instead of markdown."
   })
 }) {
 };
-var FetchResult2 = class extends effect.Schema.Class("FetchResult")({
-  content: effect.Schema.String,
-  url: effect.Schema.String,
-  meta: effect.Schema.optional(PageMeta)
-}) {
-};
 var FetchTool = ai.Tool.make("fetch", {
-  description: "Fetch and extract content from any URL.",
-  parameters: FetchParams.fields,
-  success: FetchResult2
+  description: `Fetch and extract content from any URL.
+
+Returns markdown by default. When \`search\` is provided, returns semantically relevant snippets instead.`,
+  parameters: FetchParams.fields
 }).annotate(ai.Tool.Readonly, true).annotate(ai.Tool.Destructive, false);
 var Fetch = class extends effect.Effect.Service()("Fetch", {
   dependencies: [ExpandClient.Default],
   scoped: effect.Effect.gen(function* () {
     const client = yield* ExpandClient;
-    const fetch = effect.Effect.fn("Fetch.fetch")(function* ({ url, format, includeMeta }) {
-      const formatLabel = format instanceof SnippetsFormat ? "snippets" : format;
-      yield* effect.Effect.logDebug(`Fetching: ${url}`).pipe(effect.Effect.annotateLogs({ format: formatLabel, includeMeta }));
+    const fetch = effect.Effect.fn("Fetch.fetch")(function* ({
+      url,
+      includeMeta,
+      includeAppendix,
+      includeJson,
+      search
+    }) {
+      const hasSearch = search !== void 0;
+      yield* effect.Effect.logDebug(`Fetching: ${url}`).pipe(
+        effect.Effect.annotateLogs({ hasSearch, includeMeta, includeAppendix, includeJson })
+      );
       const result = yield* client.fetch({
         url,
         select: {
-          markdown: format === "markdown",
-          html: format === "html",
-          summary: format === "summary",
-          snippets: format instanceof SnippetsFormat ? { ...format } : void 0,
-          meta: includeMeta
+          markdown: !hasSearch,
+          snippets: hasSearch ? {
+            query: search.query,
+            maxSnippets: search.maxResults,
+            minScore: search.minScore
+          } : void 0,
+          meta: includeMeta,
+          json: includeJson,
+          appendix: includeAppendix
         }
       });
-      const content = result.data.markdown ?? result.data.html ?? result.data.summary ?? result.data.snippets?.map((snippet) => `${snippet.text} (Score: ${snippet.score})`).join("\n") ?? "";
-      yield* effect.Effect.logDebug(`\u{1F4E4} Fetched successfully: ${result.data.response.url}`);
-      return new FetchResult2({
-        content,
-        url: result.data.response.url,
-        meta: result.data.meta
-      });
+      yield* effect.Effect.logDebug(`Fetched successfully: ${result.data.response.url}`);
+      return result.data;
     }, effect.Effect.orDie);
     return { fetch };
   })