@iflow-ai/search-openapi 0.1.0-pre.0

package/dist/errors.js

@@ -0,0 +1,49 @@
+/**
+ * HTTP error JSON shape used by every endpoint. The OpenAPI spec
+ * advertises the same shape so Open WebUI / Coze and other OpenAPI
+ * tool hosts can render errors uniformly.
+ *
+ * iFlow errors come pre-shaped from @iflow-ai/search-core (stable codes
+ * + messages). This module never re-derives codes — it just maps to
+ * HTTP status codes and JSON output.
+ *
+ * For api_error specifically, iFlow's own HTTP status (when present on
+ * `IFlowError.status`) wins over the default — that preserves the
+ * upstream 401 / 403 / 429 signal to clients who key off status codes.
+ */
+const STATUS_BY_CODE = {
+    missing_api_key: 401,
+    missing_param: 400,
+    invalid_param: 400,
+    network_timeout: 504,
+    network_error: 502,
+    api_error: 502,
+    api_business_error: 502,
+};
+export function statusForIFlowError(error) {
+    if (error.code === "api_error" &&
+        typeof error.status === "number" &&
+        error.status >= 400 &&
+        error.status <= 599) {
+        return error.status;
+    }
+    return STATUS_BY_CODE[error.code] ?? 500;
+}
+export function iflowErrorToBody(error) {
+    const body = {
+        ok: false,
+        error: {
+            code: error.code,
+            message: error.message,
+        },
+    };
+    if (typeof error.status === "number")
+        body.error.status = error.status;
+    if (error.detail !== undefined)
+        body.error.detail = error.detail;
+    return body;
+}
+export function genericErrorBody(code, message) {
+    return { ok: false, error: { code, message } };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAcH,MAAM,cAAc,GAAmC;IACrD,eAAe,EAAE,GAAG;IACpB,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,GAAG;IAClB,eAAe,EAAE,GAAG;IACpB,aAAa,EAAE,GAAG;IAClB,SAAS,EAAE,GAAG;IACd,kBAAkB,EAAE,GAAG;CACxB,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACnD,IACE,KAAK,CAAC,IAAI,KAAK,WAAW;QAC1B,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,KAAK,CAAC,MAAM,IAAI,GAAG;QACnB,KAAK,CAAC,MAAM,IAAI,GAAG,EACnB,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IACD,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,MAAM,IAAI,GAAc;QACtB,EAAE,EAAE,KAAK;QACT,KAAK,EAAE;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB;KACF,CAAC;IACF,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IACvE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAe;IAC5D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;AACjD,CAAC"}

package/dist/handlers/image-search.d.ts

@@ -0,0 +1,8 @@
+/**
+ * POST /tools/iflow_image_search
+ *
+ * Pass-through to IFlowSearchClient.imageSearch.
+ */
+import type { ToolHandler } from "./types.js";
+export declare const imageSearchHandler: ToolHandler;
+//# sourceMappingURL=image-search.d.ts.map

package/dist/handlers/image-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-search.d.ts","sourceRoot":"","sources":["../../src/handlers/image-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,eAAO,MAAM,kBAAkB,EAAE,WA4ChC,CAAC"}

package/dist/handlers/image-search.js

@@ -0,0 +1,53 @@
+/**
+ * POST /tools/iflow_image_search
+ *
+ * Pass-through to IFlowSearchClient.imageSearch.
+ */
+import { IMAGE_SEARCH_DEFAULT_COUNT, IMAGE_SEARCH_MAX_COUNT, } from "@iflow-ai/search-core";
+import { iflowErrorToBody, statusForIFlowError } from "../errors.js";
+const TOOL_NAME = "iflow_image_search";
+export const imageSearchHandler = {
+    name: TOOL_NAME,
+    title: "iFlow Image Search",
+    description: "Search images with iFlow. Returns image URLs, titles, and the " +
+        "source pages they appear on.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                minLength: 1,
+                description: "Image search query.",
+            },
+            count: {
+                type: "integer",
+                minimum: 1,
+                maximum: IMAGE_SEARCH_MAX_COUNT,
+                description: `Number of images (1–${IMAGE_SEARCH_MAX_COUNT}, default ${IMAGE_SEARCH_DEFAULT_COUNT}).`,
+            },
+        },
+        required: ["query"],
+        additionalProperties: false,
+    },
+    async handle(rawBody, client) {
+        const body = (rawBody ?? {});
+        const params = {
+            query: typeof body.query === "string" ? body.query : "",
+        };
+        if (body.count !== undefined) {
+            params.count = body.count;
+        }
+        const result = await client.imageSearch(params);
+        if (!result.ok) {
+            return {
+                status: statusForIFlowError(result.error),
+                body: iflowErrorToBody(result.error),
+            };
+        }
+        return {
+            status: 200,
+            body: { ok: true, data: result.data },
+        };
+    },
+};
+//# sourceMappingURL=image-search.js.map

package/dist/handlers/image-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-search.js","sourceRoot":"","sources":["../../src/handlers/image-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGrE,MAAM,SAAS,GAAG,oBAAoB,CAAC;AAEvC,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,gEAAgE;QAChE,8BAA8B;IAChC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,CAAC;gBACZ,WAAW,EAAE,qBAAqB;aACnC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,sBAAsB;gBAC/B,WAAW,EAAE,uBAAuB,sBAAsB,aAAa,0BAA0B,IAAI;aACtG;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM;QAC1B,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAyC,CAAC;QACrE,MAAM,MAAM,GAAsC;YAChD,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;SACxD,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;QACtC,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC;gBACzC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC;aACrC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;SACtC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/handlers/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ordered list of tool handlers. Order is the order they appear in
+ * /openapi.json so consumers (Open WebUI, Coze, …) get a stable
+ * tool catalog.
+ */
+import { webSearchHandler } from "./web-search.js";
+import { imageSearchHandler } from "./image-search.js";
+import { webFetchHandler } from "./web-fetch.js";
+import type { ToolHandler } from "./types.js";
+export declare const TOOL_HANDLERS: readonly ToolHandler[];
+export type { ToolHandler };
+export { webSearchHandler, imageSearchHandler, webFetchHandler };
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAI/C,CAAC;AAEF,YAAY,EAAE,WAAW,EAAE,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,CAAC"}

package/dist/handlers/index.js

@@ -0,0 +1,15 @@
+/**
+ * Ordered list of tool handlers. Order is the order they appear in
+ * /openapi.json so consumers (Open WebUI, Coze, …) get a stable
+ * tool catalog.
+ */
+import { webSearchHandler } from "./web-search.js";
+import { imageSearchHandler } from "./image-search.js";
+import { webFetchHandler } from "./web-fetch.js";
+export const TOOL_HANDLERS = [
+    webSearchHandler,
+    imageSearchHandler,
+    webFetchHandler,
+];
+export { webSearchHandler, imageSearchHandler, webFetchHandler };
+//# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,gBAAgB;IAChB,kBAAkB;IAClB,eAAe;CAChB,CAAC;AAGF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,CAAC"}

package/dist/handlers/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Per-route handler shape shared by the three iFlow Search tool endpoints.
+ *
+ * Handlers are pure functions from a parsed JSON body to an HTTP response
+ * (status code + JSON body). They never throw across the HTTP boundary —
+ * all iFlow errors are surfaced as normalized error bodies built from
+ * the IFlowError returned by @iflow-ai/search-core.
+ *
+ * The inputSchema is JSON Schema, surfaced verbatim in /openapi.json as
+ * the requestBody schema for each tool route.
+ */
+import type { IFlowSearchClient } from "@iflow-ai/search-core";
+export interface ToolHandler {
+    /** Path segment under /tools, e.g. "iflow_web_search". */
+    name: string;
+    /** Short human label used in /openapi.json summary. */
+    title: string;
+    /** Description shown to LLMs and tool catalogs. */
+    description: string;
+    /** JSON Schema for the request body. */
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+    /**
+     * Handle a parsed JSON request body. Returns the HTTP status and JSON
+     * body to send. Implementations delegate all iFlow logic to `client`
+     * and translate the IFlowResult envelope into the openapi response shape.
+     */
+    handle(rawBody: unknown, client: IFlowSearchClient): Promise<{
+        status: number;
+        body: object;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/handlers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;IACF;;;;OAIG;IACH,MAAM,CACJ,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C"}

package/dist/handlers/types.js

@@ -0,0 +1,13 @@
+/**
+ * Per-route handler shape shared by the three iFlow Search tool endpoints.
+ *
+ * Handlers are pure functions from a parsed JSON body to an HTTP response
+ * (status code + JSON body). They never throw across the HTTP boundary —
+ * all iFlow errors are surfaced as normalized error bodies built from
+ * the IFlowError returned by @iflow-ai/search-core.
+ *
+ * The inputSchema is JSON Schema, surfaced verbatim in /openapi.json as
+ * the requestBody schema for each tool route.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/handlers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/handlers/web-fetch.d.ts

@@ -0,0 +1,8 @@
+/**
+ * POST /tools/iflow_web_fetch
+ *
+ * Pass-through to IFlowSearchClient.webFetch.
+ */
+import type { ToolHandler } from "./types.js";
+export declare const webFetchHandler: ToolHandler;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/handlers/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/handlers/web-fetch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,eAAO,MAAM,eAAe,EAAE,WAiC7B,CAAC"}

package/dist/handlers/web-fetch.js

@@ -0,0 +1,41 @@
+/**
+ * POST /tools/iflow_web_fetch
+ *
+ * Pass-through to IFlowSearchClient.webFetch.
+ */
+import { iflowErrorToBody, statusForIFlowError } from "../errors.js";
+const TOOL_NAME = "iflow_web_fetch";
+export const webFetchHandler = {
+    name: TOOL_NAME,
+    title: "iFlow Web Fetch",
+    description: "Fetch the readable contents of a single URL via iFlow. Use after " +
+        "iflow_web_search picks a promising result and you want the full text.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            url: {
+                type: "string",
+                minLength: 1,
+                description: "Absolute URL of the page to fetch.",
+            },
+        },
+        required: ["url"],
+        additionalProperties: false,
+    },
+    async handle(rawBody, client) {
+        const body = (rawBody ?? {});
+        const url = typeof body.url === "string" ? body.url : "";
+        const result = await client.webFetch({ url });
+        if (!result.ok) {
+            return {
+                status: statusForIFlowError(result.error),
+                body: iflowErrorToBody(result.error),
+            };
+        }
+        return {
+            status: 200,
+            body: { ok: true, data: result.data },
+        };
+    },
+};
+//# sourceMappingURL=web-fetch.js.map

package/dist/handlers/web-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.js","sourceRoot":"","sources":["../../src/handlers/web-fetch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGrE,MAAM,SAAS,GAAG,iBAAiB,CAAC;AAEpC,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,mEAAmE;QACnE,uEAAuE;IACzE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,CAAC;gBACZ,WAAW,EAAE,oCAAoC;aAClD;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM;QAC1B,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAsB,CAAC;QAClD,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC;gBACzC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC;aACrC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;SACtC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/handlers/web-search.d.ts

@@ -0,0 +1,10 @@
+/**
+ * POST /tools/iflow_web_search
+ *
+ * Thin pass-through to IFlowSearchClient.webSearch. search-core owns
+ * query / count validation and produces IFlowError on any rejection;
+ * this module just translates the envelope into the HTTP response shape.
+ */
+import type { ToolHandler } from "./types.js";
+export declare const webSearchHandler: ToolHandler;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/handlers/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../src/handlers/web-search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,eAAO,MAAM,gBAAgB,EAAE,WA4C9B,CAAC"}

package/dist/handlers/web-search.js

@@ -0,0 +1,55 @@
+/**
+ * POST /tools/iflow_web_search
+ *
+ * Thin pass-through to IFlowSearchClient.webSearch. search-core owns
+ * query / count validation and produces IFlowError on any rejection;
+ * this module just translates the envelope into the HTTP response shape.
+ */
+import { WEB_SEARCH_DEFAULT_COUNT, WEB_SEARCH_MAX_COUNT, } from "@iflow-ai/search-core";
+import { iflowErrorToBody, statusForIFlowError } from "../errors.js";
+const TOOL_NAME = "iflow_web_search";
+export const webSearchHandler = {
+    name: TOOL_NAME,
+    title: "iFlow Web Search",
+    description: "Search the web with iFlow. Use to find current information, news, " +
+        "papers, and reference pages. Returns titles, URLs, and snippets.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                minLength: 1,
+                description: "Search query.",
+            },
+            count: {
+                type: "integer",
+                minimum: 1,
+                maximum: WEB_SEARCH_MAX_COUNT,
+                description: `Number of results (1–${WEB_SEARCH_MAX_COUNT}, default ${WEB_SEARCH_DEFAULT_COUNT}).`,
+            },
+        },
+        required: ["query"],
+        additionalProperties: false,
+    },
+    async handle(rawBody, client) {
+        const body = (rawBody ?? {});
+        const params = {
+            query: typeof body.query === "string" ? body.query : "",
+        };
+        if (body.count !== undefined) {
+            params.count = body.count;
+        }
+        const result = await client.webSearch(params);
+        if (!result.ok) {
+            return {
+                status: statusForIFlowError(result.error),
+                body: iflowErrorToBody(result.error),
+            };
+        }
+        return {
+            status: 200,
+            body: { ok: true, data: result.data },
+        };
+    },
+};
+//# sourceMappingURL=web-search.js.map

package/dist/handlers/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../src/handlers/web-search.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGrE,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC,MAAM,CAAC,MAAM,gBAAgB,GAAgB;IAC3C,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,kBAAkB;IACzB,WAAW,EACT,oEAAoE;QACpE,kEAAkE;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,CAAC;gBACZ,WAAW,EAAE,eAAe;aAC7B;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,oBAAoB;gBAC7B,WAAW,EAAE,wBAAwB,oBAAoB,aAAa,wBAAwB,IAAI;aACnG;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM;QAC1B,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAyC,CAAC;QACrE,MAAM,MAAM,GAAsC;YAChD,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;SACxD,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;QACtC,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC;gBACzC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC;aACrC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;SACtC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @iflow-ai/search-openapi — HTTP/OpenAPI tool server for the iFlow Search API.
+ *
+ * The package is primarily a CLI (`iflow-search-openapi`), but the request
+ * listener factory and config loader are exported so the server can be
+ * embedded in a larger HTTP app or driven by integration tests.
+ */
+export { createApp, type AppOptions } from "./server.js";
+export { loadConfig, ConfigError, DEFAULT_PORT, type ResolvedConfig, type EnvLike, } from "./config.js";
+export { buildOpenApiDocument } from "./openapi.js";
+export { TOOL_HANDLERS, webSearchHandler, imageSearchHandler, webFetchHandler, type ToolHandler, } from "./handlers/index.js";
+export { INTEGRATION_NAME, SOURCE, VERSION } from "./version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,OAAO,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @iflow-ai/search-openapi — HTTP/OpenAPI tool server for the iFlow Search API.
+ *
+ * The package is primarily a CLI (`iflow-search-openapi`), but the request
+ * listener factory and config loader are exported so the server can be
+ * embedded in a larger HTTP app or driven by integration tests.
+ */
+export { createApp } from "./server.js";
+export { loadConfig, ConfigError, DEFAULT_PORT, } from "./config.js";
+export { buildOpenApiDocument } from "./openapi.js";
+export { TOOL_HANDLERS, webSearchHandler, imageSearchHandler, webFetchHandler, } from "./handlers/index.js";
+export { INTEGRATION_NAME, SOURCE, VERSION } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,GAGb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAEhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/openapi.d.ts

@@ -0,0 +1,19 @@
+/**
+ * OpenAPI 3.1 description served at /openapi.json.
+ *
+ * Open WebUI and Coze (and other OpenAPI 3.x tool hosts) read this
+ * document to populate their tool catalogs. The schema is generated
+ * from the canonical TOOL_HANDLERS list so the document and the routes
+ * can never drift.
+ *
+ * Auth: when `bearerAuth` is true, every operation declares the
+ * `BearerAuth` security scheme; consumers will require the user to
+ * paste a token. /health is intentionally excluded from this document
+ * — it's a private liveness check, not a tool.
+ */
+export interface OpenApiDocumentOptions {
+    /** True when IFLOW_OPENAPI_AUTH_TOKEN is configured. */
+    bearerAuth: boolean;
+}
+export declare function buildOpenApiDocument(options: OpenApiDocumentOptions): object;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,sBAAsB,GAC9B,MAAM,CAqGR"}

package/dist/openapi.js

@@ -0,0 +1,112 @@
+/**
+ * OpenAPI 3.1 description served at /openapi.json.
+ *
+ * Open WebUI and Coze (and other OpenAPI 3.x tool hosts) read this
+ * document to populate their tool catalogs. The schema is generated
+ * from the canonical TOOL_HANDLERS list so the document and the routes
+ * can never drift.
+ *
+ * Auth: when `bearerAuth` is true, every operation declares the
+ * `BearerAuth` security scheme; consumers will require the user to
+ * paste a token. /health is intentionally excluded from this document
+ * — it's a private liveness check, not a tool.
+ */
+import { TOOL_HANDLERS } from "./handlers/index.js";
+import { VERSION } from "./version.js";
+export function buildOpenApiDocument(options) {
+    const errorSchema = {
+        type: "object",
+        required: ["ok", "error"],
+        properties: {
+            ok: { type: "boolean", enum: [false] },
+            error: {
+                type: "object",
+                required: ["code", "message"],
+                properties: {
+                    code: { type: "string" },
+                    message: { type: "string" },
+                    status: { type: "integer" },
+                    detail: {},
+                },
+            },
+        },
+    };
+    const security = options.bearerAuth ? [{ BearerAuth: [] }] : [];
+    const paths = {};
+    for (const handler of TOOL_HANDLERS) {
+        paths[`/tools/${handler.name}`] = {
+            post: {
+                operationId: handler.name,
+                summary: handler.title,
+                description: handler.description,
+                ...(security.length > 0 ? { security } : {}),
+                requestBody: {
+                    required: true,
+                    content: {
+                        "application/json": {
+                            schema: handler.inputSchema,
+                        },
+                    },
+                },
+                responses: {
+                    "200": {
+                        description: "Successful tool invocation.",
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: "object",
+                                    required: ["ok", "data"],
+                                    properties: {
+                                        ok: { type: "boolean", enum: [true] },
+                                        data: { type: "object" },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    "400": {
+                        description: "Invalid input.",
+                        content: {
+                            "application/json": { schema: errorSchema },
+                        },
+                    },
+                    "401": {
+                        description: "Missing or invalid bearer token.",
+                        content: {
+                            "application/json": { schema: errorSchema },
+                        },
+                    },
+                    "default": {
+                        description: "Error.",
+                        content: {
+                            "application/json": { schema: errorSchema },
+                        },
+                    },
+                },
+            },
+        };
+    }
+    const document = {
+        openapi: "3.1.0",
+        info: {
+            title: "iFlow Search OpenAPI",
+            version: VERSION,
+            description: "HTTP/OpenAPI tool server for the iFlow Search API. " +
+                "Exposes iflow_web_search, iflow_image_search, and iflow_web_fetch " +
+                "as POST endpoints for Open WebUI / Coze and other OpenAPI 3.x tool hosts.",
+        },
+        paths,
+    };
+    if (options.bearerAuth) {
+        document.components = {
+            securitySchemes: {
+                BearerAuth: {
+                    type: "http",
+                    scheme: "bearer",
+                },
+            },
+        };
+    }
+    return document;
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,31 @@
+/**
+ * HTTP request listener for the iFlow Search OpenAPI server.
+ *
+ * Routes:
+ *   GET  /health                       — liveness, never gated by bearer auth
+ *   GET  /openapi.json                 — OpenAPI 3.1 schema (bearer-gated when configured)
+ *   POST /tools/iflow_web_search       — search-core webSearch passthrough
+ *   POST /tools/iflow_image_search     — search-core imageSearch passthrough
+ *   POST /tools/iflow_web_fetch        — search-core webFetch passthrough
+ *
+ * Design notes:
+ *   - The server is dependency-light: just the Node built-in `http` module
+ *     plus search-core. No Express / Fastify / Koa.
+ *   - All HTTP, Authorization, attribution headers, and iFlow error mapping
+ *     live in @iflow-ai/search-core. This server only translates between
+ *     JSON-over-HTTP and the typed search-core client.
+ *   - The handler list is the single source of truth for both the routes
+ *     and /openapi.json.
+ *   - Body size is capped at MAX_BODY_BYTES to keep tool platforms from
+ *     accidentally streaming megabytes into the server.
+ */
+import type { RequestListener } from "node:http";
+import type { IFlowSearchClient } from "@iflow-ai/search-core";
+export interface AppOptions {
+    /** Authenticated iFlow client built from ResolvedConfig in bin.ts. */
+    client: IFlowSearchClient;
+    /** When set, every route except /health requires `Authorization: Bearer <token>`. */
+    authToken: string | undefined;
+}
+export declare function createApp(options: AppOptions): RequestListener;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAmB,eAAe,EAAkB,MAAM,WAAW,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAS/D,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,MAAM,EAAE,iBAAiB,CAAC;IAC1B,qFAAqF;IACrF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,eAAe,CA4E9D"}