@agnocon/piece-bocha-search 0.0.5

package/LICENSE.MIT-AP

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) Activepieces AB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Derived helpers in this folder are adapted from Activepieces (MIT) for use
+inside CX without depending on @activepieces/* packages at runtime.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare const bocha: import("@agnocon/pieces-framework").Piece<import("@agnocon/pieces-framework").SecretTextProperty<true>>;
+//# 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":"AASA,eAAO,MAAM,KAAK,yGAoBhB,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bocha = void 0;
+const tslib_1 = require("tslib");
+// Vendored from Activepieces packages/pieces/community/bocha-search/src/index.ts (MIT).
+// Generated by packages/scripts/vendor-ap.mjs - do not edit by hand.
+const pieces_framework_1 = require("@agnocon/pieces-framework");
+const pieces_common_1 = require("@agnocon/pieces-common");
+const pieces_framework_2 = require("@agnocon/pieces-framework");
+const web_search_1 = require("./lib/actions/web-search");
+const auth_1 = require("./lib/common/auth");
+const client_1 = require("./lib/common/client");
+exports.bocha = (0, pieces_framework_1.createPiece)({
+    displayName: 'Bocha',
+    description: 'Web search API for AI agents, providing real-time web pages, images, and news.',
+    minimumSupportedRelease: '0.36.1',
+    logoUrl: 'https://cdn.activepieces.com/pieces/bocha-search.png',
+    categories: [pieces_framework_2.PieceCategory.ARTIFICIAL_INTELLIGENCE],
+    authors: ['BochaLab'],
+    auth: auth_1.bochaAuth,
+    actions: [
+        web_search_1.webSearchAction,
+        (0, pieces_common_1.createCustomApiCallAction)({
+            baseUrl: () => client_1.BASE_URL,
+            auth: auth_1.bochaAuth,
+            authMapping: (auth) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+                return ({
+                    Authorization: `Bearer ${auth.secret_text}`,
+                });
+            }),
+        }),
+    ],
+    triggers: [],
+});
+//# 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,wFAAwF;AACxF,qEAAqE;AACrE,gEAAwD;AACxD,0DAAmE;AACnE,gEAA0D;AAC1D,yDAA2D;AAC3D,4CAA8C;AAC9C,gDAA+C;AAElC,QAAA,KAAK,GAAG,IAAA,8BAAW,EAAC;IAC/B,WAAW,EAAE,OAAO;IACpB,WAAW,EACT,gFAAgF;IAClF,uBAAuB,EAAE,QAAQ;IACjC,OAAO,EAAE,sDAAsD;IAC/D,UAAU,EAAE,CAAC,gCAAa,CAAC,uBAAuB,CAAC;IACnD,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,IAAI,EAAE,gBAAS;IACf,OAAO,EAAE;QACP,4BAAe;QACf,IAAA,yCAAyB,EAAC;YACxB,OAAO,EAAE,GAAG,EAAE,CAAC,iBAAQ;YACvB,IAAI,EAAE,gBAAS;YACf,WAAW,EAAE,CAAO,IAAI,EAAE,EAAE;gBAAC,OAAA,CAAC;oBAC5B,aAAa,EAAE,UAAU,IAAI,CAAC,WAAW,EAAE;iBAC5C,CAAC,CAAA;cAAA;SACH,CAAC;KACH;IACD,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC"}

package/dist/lib/actions/web-search.d.ts

@@ -0,0 +1,9 @@
+export declare const webSearchAction: import("@agnocon/pieces-framework").IAction<import("@agnocon/pieces-framework").SecretTextProperty<true>, {
+    query: import("@agnocon/pieces-framework").ShortTextProperty<true>;
+    freshness: import("@agnocon/pieces-framework").StaticDropdownProperty<string, false>;
+    summary: import("@agnocon/pieces-framework").CheckboxProperty<false>;
+    include: import("@agnocon/pieces-framework").ShortTextProperty<false>;
+    exclude: import("@agnocon/pieces-framework").ShortTextProperty<false>;
+    count: import("@agnocon/pieces-framework").NumberProperty<false>;
+}>;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/lib/actions/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../../src/lib/actions/web-search.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,eAAe;;;;;;;EA+D1B,CAAC"}

package/dist/lib/actions/web-search.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webSearchAction = void 0;
+const tslib_1 = require("tslib");
+// Vendored from Activepieces packages/pieces/community/bocha-search/src/lib/actions/web-search.ts (MIT).
+// Generated by packages/scripts/vendor-ap.mjs - do not edit by hand.
+const pieces_framework_1 = require("@agnocon/pieces-framework");
+const pieces_common_1 = require("@agnocon/pieces-common");
+const auth_1 = require("../common/auth");
+const client_1 = require("../common/client");
+const props_1 = require("../common/props");
+exports.webSearchAction = (0, pieces_framework_1.createAction)({
+    name: 'web_search',
+    displayName: 'Web Search',
+    description: 'Search the web using Bocha.',
+    audience: 'both',
+    aiMetadata: {
+        description: 'Runs a Bocha web search for a query and returns matching web pages, optionally with per-result text summaries. Pick this to look up current information on the public web; results can be narrowed by freshness window, capped result count, and include/exclude domain lists (up to 100 domains each, separated by | or ,). Read-only and idempotent — repeating the same query just fetches results again.',
+        idempotent: true,
+    },
+    auth: auth_1.bochaAuth,
+    props: {
+        query: pieces_framework_1.Property.ShortText({
+            displayName: 'Query',
+            description: 'The search query.',
+            required: true,
+        }),
+        freshness: props_1.freshnessDropdown,
+        summary: pieces_framework_1.Property.Checkbox({
+            displayName: 'Show Summary',
+            description: 'Include a text summary for each search result.',
+            required: false,
+            defaultValue: true,
+        }),
+        include: pieces_framework_1.Property.ShortText({
+            displayName: 'Include Domains',
+            description: 'Limit search to specific domains. Separate multiple domains with | or , (max 100).',
+            required: false,
+        }),
+        exclude: pieces_framework_1.Property.ShortText({
+            displayName: 'Exclude Domains',
+            description: 'Exclude specific domains from search results. Separate multiple domains with | or , (max 100).',
+            required: false,
+        }),
+        count: props_1.countProp,
+    },
+    run(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ auth, propsValue }) {
+            var _b;
+            const body = {
+                query: propsValue['query'],
+                count: propsValue['count'],
+            };
+            if (propsValue['freshness']) {
+                body['freshness'] = propsValue['freshness'];
+            }
+            if (propsValue['summary'] !== undefined && propsValue['summary'] !== null) {
+                body['summary'] = propsValue['summary'];
+            }
+            if (propsValue['include']) {
+                body['include'] = propsValue['include'];
+            }
+            if (propsValue['exclude']) {
+                body['exclude'] = propsValue['exclude'];
+            }
+            const response = yield (0, client_1.makeRequest)({
+                token: auth.secret_text,
+                method: pieces_common_1.HttpMethod.POST,
+                path: '/web-search',
+                body,
+            });
+            return (_b = response.data) !== null && _b !== void 0 ? _b : {};
+        });
+    },
+});
+//# sourceMappingURL=web-search.js.map

package/dist/lib/actions/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../../src/lib/actions/web-search.ts"],"names":[],"mappings":";;;;AAAA,yGAAyG;AACzG,qEAAqE;AACrE,gEAAmE;AACnE,0DAAoD;AACpD,yCAA2C;AAC3C,6CAA+C;AAC/C,2CAA+D;AAElD,QAAA,eAAe,GAAG,IAAA,+BAAY,EAAC;IAC1C,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,YAAY;IACzB,WAAW,EAAE,6BAA6B;IAC1C,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE;QACV,WAAW,EACT,8YAA8Y;QAChZ,UAAU,EAAE,IAAI;KACjB;IACD,IAAI,EAAE,gBAAS;IACf,KAAK,EAAE;QACL,KAAK,EAAE,2BAAQ,CAAC,SAAS,CAAC;YACxB,WAAW,EAAE,OAAO;YACpB,WAAW,EAAE,mBAAmB;YAChC,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,SAAS,EAAE,yBAAiB;QAC5B,OAAO,EAAE,2BAAQ,CAAC,QAAQ,CAAC;YACzB,WAAW,EAAE,cAAc;YAC3B,WAAW,EAAE,gDAAgD;YAC7D,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,IAAI;SACnB,CAAC;QACF,OAAO,EAAE,2BAAQ,CAAC,SAAS,CAAC;YAC1B,WAAW,EAAE,iBAAiB;YAC9B,WAAW,EAAE,oFAAoF;YACjG,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,OAAO,EAAE,2BAAQ,CAAC,SAAS,CAAC;YAC1B,WAAW,EAAE,iBAAiB;YAC9B,WAAW,EAAE,gGAAgG;YAC7G,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,KAAK,EAAE,iBAAS;KACjB;IACK,GAAG;qEAAC,EAAE,IAAI,EAAE,UAAU,EAAE;;YAC5B,MAAM,IAAI,GAA4B;gBACpC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;gBAC1B,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;aAC3B,CAAC;YACF,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,WAAW,CAAC,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YAC9C,CAAC;YACD,IAAI,UAAU,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,UAAU,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1E,IAAI,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;YAC1C,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAW,EAAyB;gBACzD,KAAK,EAAE,IAAI,CAAC,WAAW;gBACvB,MAAM,EAAE,0BAAU,CAAC,IAAI;gBACvB,IAAI,EAAE,aAAa;gBACnB,IAAI;aACL,CAAC,CAAC;YAEH,OAAO,MAAA,QAAQ,CAAC,IAAI,mCAAI,EAAE,CAAC;QAC7B,CAAC;KAAA;CACF,CAAC,CAAC"}

package/dist/lib/common/auth.d.ts

@@ -0,0 +1,2 @@
+export declare const bochaAuth: import("@agnocon/pieces-framework").SecretTextProperty<true>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/lib/common/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/lib/common/auth.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,SAAS,8DA4BpB,CAAC"}

package/dist/lib/common/auth.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bochaAuth = void 0;
+const tslib_1 = require("tslib");
+// Vendored from Activepieces packages/pieces/community/bocha-search/src/lib/common/auth.ts (MIT).
+// Generated by packages/scripts/vendor-ap.mjs - do not edit by hand.
+const pieces_framework_1 = require("@agnocon/pieces-framework");
+const pieces_common_1 = require("@agnocon/pieces-common");
+const client_1 = require("./client");
+const markdownDescription = `
+Follow these steps to obtain your Bocha API Key:
+
+1. Visit [Bocha AI Open Platform](https://open.bochaai.com) and create an account.
+2. Navigate to **API KEY Management** in the dashboard.
+3. Copy your API key.
+`;
+exports.bochaAuth = pieces_framework_1.PieceAuth.SecretText({
+    displayName: 'API Key',
+    description: markdownDescription,
+    required: true,
+    validate: (_a) => tslib_1.__awaiter(void 0, [_a], void 0, function* ({ auth }) {
+        try {
+            yield (0, client_1.makeRequest)({
+                token: auth,
+                method: pieces_common_1.HttpMethod.POST,
+                path: '/web-search',
+                body: { query: 'test', count: 1 },
+            });
+            return {
+                valid: true,
+            };
+        }
+        catch (e) {
+            const response = isRecord(e) ? e['response'] : undefined;
+            const status = isRecord(response) && typeof response['status'] === 'number'
+                ? response['status']
+                : undefined;
+            if (status === 401 || status === 403) {
+                return { valid: false, error: 'Invalid API Key' };
+            }
+            return { valid: false, error: 'Could not connect to Bocha API. Please try again.' };
+        }
+    }),
+});
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=auth.js.map

package/dist/lib/common/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/lib/common/auth.ts"],"names":[],"mappings":";;;;AAAA,kGAAkG;AAClG,qEAAqE;AACrE,gEAAsD;AACtD,0DAAoD;AACpD,qCAAuC;AAEvC,MAAM,mBAAmB,GAAG;;;;;;CAM3B,CAAC;AAEW,QAAA,SAAS,GAAG,4BAAS,CAAC,UAAU,CAAC;IAC5C,WAAW,EAAE,SAAS;IACtB,WAAW,EAAE,mBAAmB;IAChC,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,KAAiB,EAAE,oDAAZ,EAAE,IAAI,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,IAAA,oBAAW,EAAC;gBAChB,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,0BAAU,CAAC,IAAI;gBACvB,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;aAClC,CAAC,CAAC;YACH,OAAO;gBACL,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,EAAE,CAAC;YACT,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACzD,MAAM,MAAM,GACV,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,QAAQ;gBAC1D,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACpB,CAAC,CAAC,SAAS,CAAC;YAChB,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACrC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;YACpD,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mDAAmD,EAAE,CAAC;QACtF,CAAC;IACH,CAAC,CAAA;CACF,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/lib/common/client.d.ts

@@ -0,0 +1,11 @@
+import { HttpMethod } from '@agnocon/pieces-common';
+export declare function makeRequest<T = unknown>({ token, method, path, body, }: MakeRequestParams): Promise<T>;
+export declare const BASE_URL = "https://api.bochaai.com/v1";
+type MakeRequestParams = {
+    token: string;
+    method: HttpMethod;
+    path: string;
+    body?: unknown;
+};
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/lib/common/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/lib/common/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkC,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpF,wBAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,EAC7C,KAAK,EACL,MAAM,EACN,IAAI,EACJ,IAAI,GACL,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAchC;AAED,eAAO,MAAM,QAAQ,+BAA+B,CAAC;AAErD,KAAK,iBAAiB,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC"}

package/dist/lib/common/client.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_URL = void 0;
+exports.makeRequest = makeRequest;
+const tslib_1 = require("tslib");
+// Vendored from Activepieces packages/pieces/community/bocha-search/src/lib/common/client.ts (MIT).
+// Generated by packages/scripts/vendor-ap.mjs - do not edit by hand.
+const pieces_common_1 = require("@agnocon/pieces-common");
+function makeRequest(_a) {
+    return tslib_1.__awaiter(this, arguments, void 0, function* ({ token, method, path, body, }) {
+        const response = yield pieces_common_1.httpClient.sendRequest({
+            method,
+            url: `${exports.BASE_URL}${path}`,
+            authentication: {
+                type: pieces_common_1.AuthenticationType.BEARER_TOKEN,
+                token,
+            },
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body,
+        });
+        return response.body;
+    });
+}
+exports.BASE_URL = 'https://api.bochaai.com/v1';
+//# sourceMappingURL=client.js.map

package/dist/lib/common/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/lib/common/client.ts"],"names":[],"mappings":";;;AAIA,kCAmBC;;AAvBD,oGAAoG;AACpG,qEAAqE;AACrE,0DAAoF;AAEpF,SAAsB,WAAW;iEAAc,EAC7C,KAAK,EACL,MAAM,EACN,IAAI,EACJ,IAAI,GACc;QAClB,MAAM,QAAQ,GAAG,MAAM,0BAAU,CAAC,WAAW,CAAI;YAC/C,MAAM;YACN,GAAG,EAAE,GAAG,gBAAQ,GAAG,IAAI,EAAE;YACzB,cAAc,EAAE;gBACd,IAAI,EAAE,kCAAkB,CAAC,YAAY;gBACrC,KAAK;aACN;YACD,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI;SACL,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CAAA;AAEY,QAAA,QAAQ,GAAG,4BAA4B,CAAC"}

package/dist/lib/common/props.d.ts

@@ -0,0 +1,3 @@
+export declare const freshnessDropdown: import("@agnocon/pieces-framework").StaticDropdownProperty<string, false>;
+export declare const countProp: import("@agnocon/pieces-framework").NumberProperty<false>;
+//# sourceMappingURL=props.d.ts.map

package/dist/lib/common/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/lib/common/props.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,2EAc5B,CAAC;AAEH,eAAO,MAAM,SAAS,2DAKpB,CAAC"}

package/dist/lib/common/props.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countProp = exports.freshnessDropdown = void 0;
+// Vendored from Activepieces packages/pieces/community/bocha-search/src/lib/common/props.ts (MIT).
+// Generated by packages/scripts/vendor-ap.mjs - do not edit by hand.
+const pieces_framework_1 = require("@agnocon/pieces-framework");
+exports.freshnessDropdown = pieces_framework_1.Property.StaticDropdown({
+    displayName: 'Freshness',
+    description: 'Filter results by time range. Defaults to no limit.',
+    required: false,
+    defaultValue: 'noLimit',
+    options: {
+        options: [
+            { label: 'No Limit', value: 'noLimit' },
+            { label: 'One Day', value: 'oneDay' },
+            { label: 'One Week', value: 'oneWeek' },
+            { label: 'One Month', value: 'oneMonth' },
+            { label: 'One Year', value: 'oneYear' },
+        ],
+    },
+});
+exports.countProp = pieces_framework_1.Property.Number({
+    displayName: 'Count',
+    description: 'Number of results to return (1-50). Defaults to 10.',
+    required: false,
+    defaultValue: 10,
+});
+//# sourceMappingURL=props.js.map

package/dist/lib/common/props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.js","sourceRoot":"","sources":["../../../src/lib/common/props.ts"],"names":[],"mappings":";;;AAAA,mGAAmG;AACnG,qEAAqE;AACrE,gEAAqD;AAExC,QAAA,iBAAiB,GAAG,2BAAQ,CAAC,cAAc,CAAC;IACvD,WAAW,EAAE,WAAW;IACxB,WAAW,EAAE,qDAAqD;IAClE,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,SAAS;IACvB,OAAO,EAAE;QACP,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE;YACvC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE;YACrC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE;YACvC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE;YACzC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE;SACxC;KACF;CACF,CAAC,CAAC;AAEU,QAAA,SAAS,GAAG,2BAAQ,CAAC,MAAM,CAAC;IACvC,WAAW,EAAE,OAAO;IACpB,WAAW,EAAE,qDAAqD;IAClE,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,EAAE;CACjB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@agnocon/piece-bocha-search",
+  "version": "0.0.5",
+  "description": "AgnoCon bocha search connector",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE.MIT-AP"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "vendor": "node ../scripts/vendor-ap.mjs piece-bocha-search"
+  },
+  "dependencies": {
+    "@agnocon/core-utils": "0.2.0",
+    "@agnocon/piece-types": "0.3.1",
+    "@agnocon/pieces-common": "0.12.8",
+    "@agnocon/pieces-framework": "0.36.0",
+    "tslib": "2.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "20.17.6",
+    "typescript": "5.5.4"
+  },
+  "license": "MIT",
+  "agnocon": {
+    "originVersion": "0.0.5"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "tag": "latest"
+  },
+  "keywords": [
+    "agnocon",
+    "connector"
+  ]
+}

package/src/index.ts

@@ -0,0 +1,28 @@
+import { createPiece } from '@agnocon/pieces-framework';
+import { createCustomApiCallAction } from '@agnocon/pieces-common';
+import { PieceCategory } from '@agnocon/pieces-framework';
+import { webSearchAction } from './lib/actions/web-search';
+import { bochaAuth } from './lib/common/auth';
+import { BASE_URL } from './lib/common/client';
+
+export const bocha = createPiece({
+  displayName: 'Bocha',
+  description:
+    'Web search API for AI agents, providing real-time web pages, images, and news.',
+  minimumSupportedRelease: '0.36.1',
+  logoUrl: 'https://cdn.activepieces.com/pieces/bocha-search.png',
+  categories: [PieceCategory.ARTIFICIAL_INTELLIGENCE],
+  authors: ['BochaLab'],
+  auth: bochaAuth,
+  actions: [
+    webSearchAction,
+    createCustomApiCallAction({
+      baseUrl: () => BASE_URL,
+      auth: bochaAuth,
+      authMapping: async (auth) => ({
+        Authorization: `Bearer ${auth.secret_text}`,
+      }),
+    }),
+  ],
+  triggers: [],
+});

package/src/lib/actions/web-search.ts

@@ -0,0 +1,99 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { HttpMethod } from '@agnocon/pieces-common';
+import { bochaAuth } from '../common/auth';
+import { makeRequest } from '../common/client';
+import { freshnessDropdown, countProp } from '../common/props';
+
+export const webSearchAction = createAction({
+  name: 'web_search',
+  displayName: 'Web Search',
+  description: 'Search the web using Bocha.',
+  audience: 'both',
+  aiMetadata: {
+    description:
+      'Runs a Bocha web search for a query and returns matching web pages, optionally with per-result text summaries. Pick this to look up current information on the public web; results can be narrowed by freshness window, capped result count, and include/exclude domain lists (up to 100 domains each, separated by | or ,). Read-only and idempotent — repeating the same query just fetches results again.',
+    idempotent: true,
+  },
+  auth: bochaAuth,
+  props: {
+    query: Property.ShortText({
+      displayName: 'Query',
+      description: 'The search query.',
+      required: true,
+    }),
+    freshness: freshnessDropdown,
+    summary: Property.Checkbox({
+      displayName: 'Show Summary',
+      description: 'Include a text summary for each search result.',
+      required: false,
+      defaultValue: true,
+    }),
+    include: Property.ShortText({
+      displayName: 'Include Domains',
+      description: 'Limit search to specific domains. Separate multiple domains with | or , (max 100).',
+      required: false,
+    }),
+    exclude: Property.ShortText({
+      displayName: 'Exclude Domains',
+      description: 'Exclude specific domains from search results. Separate multiple domains with | or , (max 100).',
+      required: false,
+    }),
+    count: countProp,
+  },
+  async run({ auth, propsValue }) {
+    const body: Record<string, unknown> = {
+      query: propsValue['query'],
+      count: propsValue['count'],
+    };
+    if (propsValue['freshness']) {
+      body['freshness'] = propsValue['freshness'];
+    }
+    if (propsValue['summary'] !== undefined && propsValue['summary'] !== null) {
+      body['summary'] = propsValue['summary'];
+    }
+    if (propsValue['include']) {
+      body['include'] = propsValue['include'];
+    }
+    if (propsValue['exclude']) {
+      body['exclude'] = propsValue['exclude'];
+    }
+
+    const response = await makeRequest<BochaWebSearchResponse>({
+      token: auth.secret_text,
+      method: HttpMethod.POST,
+      path: '/web-search',
+      body,
+    });
+
+    return response.data ?? {};
+  },
+});
+
+type BochaWebPage = {
+  id?: string;
+  name?: string;
+  url?: string;
+  displayUrl?: string;
+  snippet?: string;
+  summary?: string;
+  siteName?: string;
+  siteIcon?: string;
+  datePublished?: string;
+  dateLastCrawled?: string;
+  cachedPageUrl?: string;
+  language?: string;
+  isFamilyFriendly?: boolean;
+  isNavigational?: boolean;
+};
+
+type BochaWebSearchResponse = {
+  data?: {
+    _type?: string;
+    queryContext?: unknown;
+    webPages?: {
+      value?: BochaWebPage[];
+    };
+    images?: unknown;
+    videos?: unknown;
+  };
+};

package/src/lib/common/auth.ts

@@ -0,0 +1,45 @@
+import { PieceAuth } from '@agnocon/pieces-framework';
+import { HttpMethod } from '@agnocon/pieces-common';
+import { makeRequest } from './client';
+
+const markdownDescription = `
+Follow these steps to obtain your Bocha API Key:
+
+1. Visit [Bocha AI Open Platform](https://open.bochaai.com) and create an account.
+2. Navigate to **API KEY Management** in the dashboard.
+3. Copy your API key.
+`;
+
+export const bochaAuth = PieceAuth.SecretText({
+  displayName: 'API Key',
+  description: markdownDescription,
+  required: true,
+  validate: async ({ auth }) => {
+    try {
+      await makeRequest({
+        token: auth,
+        method: HttpMethod.POST,
+        path: '/web-search',
+        body: { query: 'test', count: 1 },
+      });
+      return {
+        valid: true,
+      };
+    }
+    catch (e) {
+      const response = isRecord(e) ? e['response'] : undefined;
+      const status =
+        isRecord(response) && typeof response['status'] === 'number'
+          ? response['status']
+          : undefined;
+      if (status === 401 || status === 403) {
+        return { valid: false, error: 'Invalid API Key' };
+      }
+      return { valid: false, error: 'Could not connect to Bocha API. Please try again.' };
+    }
+  },
+});
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null;
+}

package/src/lib/common/client.ts

@@ -0,0 +1,31 @@
+import { AuthenticationType, httpClient, HttpMethod } from '@agnocon/pieces-common';
+
+export async function makeRequest<T = unknown>({
+  token,
+  method,
+  path,
+  body,
+}: MakeRequestParams): Promise<T> {
+  const response = await httpClient.sendRequest<T>({
+    method,
+    url: `${BASE_URL}${path}`,
+    authentication: {
+      type: AuthenticationType.BEARER_TOKEN,
+      token,
+    },
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body,
+  });
+  return response.body;
+}
+
+export const BASE_URL = 'https://api.bochaai.com/v1';
+
+type MakeRequestParams = {
+  token: string;
+  method: HttpMethod;
+  path: string;
+  body?: unknown;
+};

package/src/lib/common/props.ts

@@ -0,0 +1,24 @@
+import { Property } from '@agnocon/pieces-framework';
+
+export const freshnessDropdown = Property.StaticDropdown({
+  displayName: 'Freshness',
+  description: 'Filter results by time range. Defaults to no limit.',
+  required: false,
+  defaultValue: 'noLimit',
+  options: {
+    options: [
+      { label: 'No Limit', value: 'noLimit' },
+      { label: 'One Day', value: 'oneDay' },
+      { label: 'One Week', value: 'oneWeek' },
+      { label: 'One Month', value: 'oneMonth' },
+      { label: 'One Year', value: 'oneYear' },
+    ],
+  },
+});
+
+export const countProp = Property.Number({
+  displayName: 'Count',
+  description: 'Number of results to return (1-50). Defaults to 10.',
+  required: false,
+  defaultValue: 10,
+});