langchain 0.0.203 → 0.0.204-rc.0

package/dist/llms/googlevertexai/common.js

@@ -1,164 +0,0 @@
-import { BaseLLM } from "../base.js";
-import { GenerationChunk } from "../../schema/index.js";
-/**
- * Base class for Google Vertex AI LLMs.
- * Implemented subclasses must provide a GoogleVertexAILLMConnection
- * with an appropriate auth client.
- */
-export class BaseGoogleVertexAI extends BaseLLM {
-    get lc_aliases() {
-        return {
-            model: "model_name",
-        };
-    }
-    constructor(fields) {
-        super(fields ?? {});
-        Object.defineProperty(this, "lc_serializable", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: true
-        });
-        Object.defineProperty(this, "model", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "text-bison"
-        });
-        Object.defineProperty(this, "temperature", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0.7
-        });
-        Object.defineProperty(this, "maxOutputTokens", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 1024
-        });
-        Object.defineProperty(this, "topP", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0.8
-        });
-        Object.defineProperty(this, "topK", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 40
-        });
-        Object.defineProperty(this, "connection", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "streamedConnection", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.model = fields?.model ?? this.model;
-        // Change the defaults for code models
-        if (this.model.startsWith("code-gecko")) {
-            this.maxOutputTokens = 64;
-        }
-        if (this.model.startsWith("code-")) {
-            this.temperature = 0.2;
-        }
-        this.temperature = fields?.temperature ?? this.temperature;
-        this.maxOutputTokens = fields?.maxOutputTokens ?? this.maxOutputTokens;
-        this.topP = fields?.topP ?? this.topP;
-        this.topK = fields?.topK ?? this.topK;
-    }
-    _llmType() {
-        return "vertexai";
-    }
-    async *_streamResponseChunks(_input, _options, _runManager) {
-        // Make the call as a streaming request
-        const instance = this.formatInstance(_input);
-        const parameters = this.formatParameters();
-        const result = await this.streamedConnection.request([instance], parameters, _options);
-        // Get the streaming parser of the response
-        const stream = result.data;
-        // Loop until the end of the stream
-        // During the loop, yield each time we get a chunk from the streaming parser
-        // that is either available or added to the queue
-        while (!stream.streamDone) {
-            const output = await stream.nextChunk();
-            const chunk = output !== null
-                ? new GenerationChunk(this.extractGenerationFromPrediction(output.outputs[0]))
-                : new GenerationChunk({
-                    text: "",
-                    generationInfo: { finishReason: "stop" },
-                });
-            yield chunk;
-        }
-    }
-    async _generate(prompts, options) {
-        const generations = await Promise.all(prompts.map((prompt) => this._generatePrompt(prompt, options)));
-        return { generations };
-    }
-    async _generatePrompt(prompt, options) {
-        const instance = this.formatInstance(prompt);
-        const parameters = this.formatParameters();
-        const result = await this.connection.request([instance], parameters, options);
-        const prediction = this.extractPredictionFromResponse(result);
-        return [this.extractGenerationFromPrediction(prediction)];
-    }
-    /**
-     * Formats the input instance as a text instance for the Google Vertex AI
-     * model.
-     * @param prompt Prompt to be formatted as a text instance.
-     * @returns A GoogleVertexAILLMInstance object representing the formatted text instance.
-     */
-    formatInstanceText(prompt) {
-        return { content: prompt };
-    }
-    /**
-     * Formats the input instance as a code instance for the Google Vertex AI
-     * model.
-     * @param prompt Prompt to be formatted as a code instance.
-     * @returns A GoogleVertexAILLMInstance object representing the formatted code instance.
-     */
-    formatInstanceCode(prompt) {
-        return { prefix: prompt };
-    }
-    /**
-     * Formats the input instance for the Google Vertex AI model based on the
-     * model type (text or code).
-     * @param prompt Prompt to be formatted as an instance.
-     * @returns A GoogleVertexAILLMInstance object representing the formatted instance.
-     */
-    formatInstance(prompt) {
-        return this.model.startsWith("code-")
-            ? this.formatInstanceCode(prompt)
-            : this.formatInstanceText(prompt);
-    }
-    formatParameters() {
-        return {
-            temperature: this.temperature,
-            topK: this.topK,
-            topP: this.topP,
-            maxOutputTokens: this.maxOutputTokens,
-        };
-    }
-    /**
-     * Extracts the prediction from the API response.
-     * @param result The API response from which to extract the prediction.
-     * @returns A TextPrediction object representing the extracted prediction.
-     */
-    extractPredictionFromResponse(result) {
-        return result?.data
-            ?.predictions[0];
-    }
-    extractGenerationFromPrediction(prediction) {
-        return {
-            text: prediction.content,
-            generationInfo: prediction,
-        };
-    }
-}

package/dist/tools/gmail/base.cjs

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GmailBaseTool = void 0;
-const googleapis_1 = require("googleapis");
-const zod_1 = require("zod");
-const base_js_1 = require("../base.cjs");
-const env_js_1 = require("../../util/env.cjs");
-class GmailBaseTool extends base_js_1.StructuredTool {
-    constructor(fields) {
-        super(...arguments);
-        Object.defineProperty(this, "CredentialsSchema", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: zod_1.z
-                .object({
-                clientEmail: zod_1.z
-                    .string()
-                    .min(1)
-                    .default((0, env_js_1.getEnvironmentVariable)("GMAIL_CLIENT_EMAIL") ?? ""),
-                privateKey: zod_1.z
-                    .string()
-                    .default((0, env_js_1.getEnvironmentVariable)("GMAIL_PRIVATE_KEY") ?? ""),
-                keyfile: zod_1.z
-                    .string()
-                    .default((0, env_js_1.getEnvironmentVariable)("GMAIL_KEYFILE") ?? ""),
-            })
-                .refine((credentials) => credentials.privateKey !== "" || credentials.keyfile !== "", {
-                message: "Missing GMAIL_PRIVATE_KEY or GMAIL_KEYFILE to interact with Gmail",
-            })
-        });
-        Object.defineProperty(this, "GmailBaseToolParamsSchema", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: zod_1.z
-                .object({
-                credentials: this.CredentialsSchema.default({}),
-                scopes: zod_1.z.array(zod_1.z.string()).default(["https://mail.google.com/"]),
-            })
-                .default({})
-        });
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "Gmail"
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "A tool to send and view emails through Gmail"
-        });
-        Object.defineProperty(this, "gmail", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        const { credentials, scopes } = this.GmailBaseToolParamsSchema.parse(fields);
-        this.gmail = this.getGmail(scopes, credentials.clientEmail, credentials.privateKey, credentials.keyfile);
-    }
-    getGmail(scopes, email, key, keyfile) {
-        const auth = new googleapis_1.google.auth.JWT(email, keyfile, key, scopes);
-        return googleapis_1.google.gmail({ version: "v1", auth });
-    }
-}
-exports.GmailBaseTool = GmailBaseTool;

package/dist/tools/gmail/base.d.ts

@@ -1,19 +0,0 @@
-import { gmail_v1 } from "googleapis";
-import { StructuredTool } from "../base.js";
-export interface GmailBaseToolParams {
-    credentials?: {
-        clientEmail?: string;
-        privateKey?: string;
-        keyfile?: string;
-    };
-    scopes?: string[];
-}
-export declare abstract class GmailBaseTool extends StructuredTool {
-    private CredentialsSchema;
-    private GmailBaseToolParamsSchema;
-    name: string;
-    description: string;
-    protected gmail: gmail_v1.Gmail;
-    constructor(fields?: Partial<GmailBaseToolParams>);
-    private getGmail;
-}

package/dist/tools/gmail/base.js

@@ -1,65 +0,0 @@
-import { google } from "googleapis";
-import { z } from "zod";
-import { StructuredTool } from "../base.js";
-import { getEnvironmentVariable } from "../../util/env.js";
-export class GmailBaseTool extends StructuredTool {
-    constructor(fields) {
-        super(...arguments);
-        Object.defineProperty(this, "CredentialsSchema", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: z
-                .object({
-                clientEmail: z
-                    .string()
-                    .min(1)
-                    .default(getEnvironmentVariable("GMAIL_CLIENT_EMAIL") ?? ""),
-                privateKey: z
-                    .string()
-                    .default(getEnvironmentVariable("GMAIL_PRIVATE_KEY") ?? ""),
-                keyfile: z
-                    .string()
-                    .default(getEnvironmentVariable("GMAIL_KEYFILE") ?? ""),
-            })
-                .refine((credentials) => credentials.privateKey !== "" || credentials.keyfile !== "", {
-                message: "Missing GMAIL_PRIVATE_KEY or GMAIL_KEYFILE to interact with Gmail",
-            })
-        });
-        Object.defineProperty(this, "GmailBaseToolParamsSchema", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: z
-                .object({
-                credentials: this.CredentialsSchema.default({}),
-                scopes: z.array(z.string()).default(["https://mail.google.com/"]),
-            })
-                .default({})
-        });
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "Gmail"
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "A tool to send and view emails through Gmail"
-        });
-        Object.defineProperty(this, "gmail", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        const { credentials, scopes } = this.GmailBaseToolParamsSchema.parse(fields);
-        this.gmail = this.getGmail(scopes, credentials.clientEmail, credentials.privateKey, credentials.keyfile);
-    }
-    getGmail(scopes, email, key, keyfile) {
-        const auth = new google.auth.JWT(email, keyfile, key, scopes);
-        return google.gmail({ version: "v1", auth });
-    }
-}

package/dist/tools/gmail/create_draft.cjs

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GmailCreateDraft = void 0;
-const zod_1 = require("zod");
-const base_js_1 = require("./base.cjs");
-const descriptions_js_1 = require("./descriptions.cjs");
-class GmailCreateDraft extends base_js_1.GmailBaseTool {
-    constructor(fields) {
-        super(fields);
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "create_gmail_draft"
-        });
-        Object.defineProperty(this, "schema", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: zod_1.z.object({
-                message: zod_1.z.string(),
-                to: zod_1.z.array(zod_1.z.string()),
-                subject: zod_1.z.string(),
-                cc: zod_1.z.array(zod_1.z.string()).optional(),
-                bcc: zod_1.z.array(zod_1.z.string()).optional(),
-            })
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: descriptions_js_1.CREATE_DRAFT_DESCRIPTION
-        });
-    }
-    prepareDraftMessage(message, to, subject, cc, bcc) {
-        const draftMessage = {
-            message: {
-                raw: "",
-            },
-        };
-        const email = [
-            `To: ${to.join(", ")}`,
-            `Subject: ${subject}`,
-            cc ? `Cc: ${cc.join(", ")}` : "",
-            bcc ? `Bcc: ${bcc.join(", ")}` : "",
-            "",
-            message,
-        ].join("\n");
-        draftMessage.message.raw = Buffer.from(email).toString("base64url");
-        return draftMessage;
-    }
-    async _call(arg) {
-        const { message, to, subject, cc, bcc } = arg;
-        const create_message = this.prepareDraftMessage(message, to, subject, cc, bcc);
-        const response = await this.gmail.users.drafts.create({
-            userId: "me",
-            requestBody: create_message,
-        });
-        return `Draft created. Draft Id: ${response.data.id}`;
-    }
-}
-exports.GmailCreateDraft = GmailCreateDraft;

package/dist/tools/gmail/create_draft.d.ts

@@ -1,35 +0,0 @@
-import { z } from "zod";
-import { GmailBaseTool, GmailBaseToolParams } from "./base.js";
-export declare class GmailCreateDraft extends GmailBaseTool {
-    name: string;
-    schema: z.ZodObject<{
-        message: z.ZodString;
-        to: z.ZodArray<z.ZodString, "many">;
-        subject: z.ZodString;
-        cc: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        bcc: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        message: string;
-        subject: string;
-        to: string[];
-        cc?: string[] | undefined;
-        bcc?: string[] | undefined;
-    }, {
-        message: string;
-        subject: string;
-        to: string[];
-        cc?: string[] | undefined;
-        bcc?: string[] | undefined;
-    }>;
-    description: string;
-    constructor(fields?: GmailBaseToolParams);
-    private prepareDraftMessage;
-    _call(arg: z.output<typeof this.schema>): Promise<string>;
-}
-export type CreateDraftSchema = {
-    message: string;
-    to: string[];
-    subject: string;
-    cc?: string[];
-    bcc?: string[];
-};

package/dist/tools/gmail/create_draft.js

@@ -1,58 +0,0 @@
-import { z } from "zod";
-import { GmailBaseTool } from "./base.js";
-import { CREATE_DRAFT_DESCRIPTION } from "./descriptions.js";
-export class GmailCreateDraft extends GmailBaseTool {
-    constructor(fields) {
-        super(fields);
-        Object.defineProperty(this, "name", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: "create_gmail_draft"
-        });
-        Object.defineProperty(this, "schema", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: z.object({
-                message: z.string(),
-                to: z.array(z.string()),
-                subject: z.string(),
-                cc: z.array(z.string()).optional(),
-                bcc: z.array(z.string()).optional(),
-            })
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: CREATE_DRAFT_DESCRIPTION
-        });
-    }
-    prepareDraftMessage(message, to, subject, cc, bcc) {
-        const draftMessage = {
-            message: {
-                raw: "",
-            },
-        };
-        const email = [
-            `To: ${to.join(", ")}`,
-            `Subject: ${subject}`,
-            cc ? `Cc: ${cc.join(", ")}` : "",
-            bcc ? `Bcc: ${bcc.join(", ")}` : "",
-            "",
-            message,
-        ].join("\n");
-        draftMessage.message.raw = Buffer.from(email).toString("base64url");
-        return draftMessage;
-    }
-    async _call(arg) {
-        const { message, to, subject, cc, bcc } = arg;
-        const create_message = this.prepareDraftMessage(message, to, subject, cc, bcc);
-        const response = await this.gmail.users.drafts.create({
-            userId: "me",
-            requestBody: create_message,
-        });
-        return `Draft created. Draft Id: ${response.data.id}`;
-    }
-}

package/dist/tools/gmail/descriptions.cjs

@@ -1,118 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SEARCH_DESCRIPTION = exports.SEND_MESSAGE_DESCRIPTION = exports.GET_THREAD_DESCRIPTION = exports.GET_MESSAGE_DESCRIPTION = exports.CREATE_DRAFT_DESCRIPTION = void 0;
-exports.CREATE_DRAFT_DESCRIPTION = `A tool for creating draft emails in Gmail.
-
-INPUT example:
-{
-  "message": "Hello, this is a test draft",
-  "to": ["example1@email.com", "example2@email.com"],
-  "subject": "Test Draft",
-  "cc": ["cc1@email.com"],
-  "bcc": ["bcc1@email.com"]
-}
-
-OUTPUT:
-The output is a confirmation message with the draft ID.
-`;
-exports.GET_MESSAGE_DESCRIPTION = `A tool for retrieving a specific email message from Gmail using its message ID.
-
-INPUT example:
-{
-  "messageId": "unique_message_id_string"
-}
-
-OUTPUT:
-The output includes detailed information about the retrieved email message. This includes the subject, body, sender (from), recipients (to), date of the email, and the message ID. If any of these details are not available in the email, the tool will throw an error indicating the missing information.
-
-Example Output:
-"Result for the prompt unique_message_id_string
-{
-  'subject': 'Email Subject',
-  'body': 'Email Body Content',
-  'from': 'sender@email.com',
-  'to': 'recipient@email.com',
-  'date': 'Email Date',
-  'messageId': 'unique_message_id_string'
-}"
-`;
-exports.GET_THREAD_DESCRIPTION = `A tool for retrieving an entire email thread from Gmail using the thread ID.
-
-INPUT example:
-{
-  "threadId": "unique_thread_id_string"
-}
-
-OUTPUT:
-The output includes an array of all the messages in the specified thread. Each message in the array contains detailed information including the subject, body, sender (from), recipients (to), date of the email, and the message ID. If any of these details are not available in a message, the tool will throw an error indicating the missing information.
-
-Example Output:
-"Result for the prompt unique_thread_id_string
-[
-  {
-    'subject': 'Email Subject',
-    'body': 'Email Body Content',
-    'from': 'sender@email.com',
-    'to': 'recipient@email.com',
-    'date': 'Email Date',
-    'messageId': 'unique_message_id_string'
-  },
-  ... (other messages in the thread)
-]"
-`;
-exports.SEND_MESSAGE_DESCRIPTION = `A tool for sending an email message using Gmail. It allows users to specify recipients, subject, and the content of the message, along with optional cc and bcc fields.
-
-INPUT example:
-{
-  "message": "Hello, this is a test email",
-  "to": ["recipient1@email.com", "recipient2@email.com"],
-  "subject": "Test Email",
-  "cc": ["cc1@email.com"],
-  "bcc": ["bcc1@email.com"]
-}
-
-OUTPUT:
-The output is a confirmation message with the ID of the sent email. If there is an error during the sending process, the tool will throw an error with a description of the problem.
-
-Example Output:
-"Message sent. Message Id: unique_message_id_string"
-`;
-exports.SEARCH_DESCRIPTION = `A tool for searching email messages or threads in Gmail using a specific query. It offers the flexibility to choose between messages and threads as the search resource.
-
-INPUT example:
-{
-  "query": "specific search query",
-  "maxResults": 10, // Optional: number of results to return
-  "resource": "messages" // Optional: can be "messages" or "threads"
-}
-
-OUTPUT:
-The output is a JSON list of either email messages or threads, depending on the specified resource, that matches the search query. For 'messages', the output includes details like the message ID, thread ID, snippet, body, subject, and sender of each message. For 'threads', it includes the thread ID, snippet, body, subject, and sender of the first message in each thread. If no data is returned, or if the specified resource is invalid, the tool throws an error with a relevant message.
-
-Example Output for 'messages':
-"Result for the query 'specific search query':
-[
-  {
-    'id': 'message_id',
-    'threadId': 'thread_id',
-    'snippet': 'message snippet',
-    'body': 'message body',
-    'subject': 'message subject',
-    'sender': 'sender's email'
-  },
-  ... (other messages matching the query)
-]"
-
-Example Output for 'threads':
-"Result for the query 'specific search query':
-[
-  {
-    'id': 'thread_id',
-    'snippet': 'thread snippet',
-    'body': 'first message body',
-    'subject': 'first message subject',
-    'sender': 'first message sender'
-  },
-  ... (other threads matching the query)
-]"
-`;

package/dist/tools/gmail/descriptions.d.ts

@@ -1,5 +0,0 @@
-export declare const CREATE_DRAFT_DESCRIPTION = "A tool for creating draft emails in Gmail.\n\nINPUT example:\n{\n  \"message\": \"Hello, this is a test draft\",\n  \"to\": [\"example1@email.com\", \"example2@email.com\"],\n  \"subject\": \"Test Draft\",\n  \"cc\": [\"cc1@email.com\"],\n  \"bcc\": [\"bcc1@email.com\"]\n}\n\nOUTPUT:\nThe output is a confirmation message with the draft ID.\n";
-export declare const GET_MESSAGE_DESCRIPTION = "A tool for retrieving a specific email message from Gmail using its message ID.\n\nINPUT example:\n{\n  \"messageId\": \"unique_message_id_string\"\n}\n\nOUTPUT:\nThe output includes detailed information about the retrieved email message. This includes the subject, body, sender (from), recipients (to), date of the email, and the message ID. If any of these details are not available in the email, the tool will throw an error indicating the missing information.\n\nExample Output:\n\"Result for the prompt unique_message_id_string\n{\n  'subject': 'Email Subject',\n  'body': 'Email Body Content',\n  'from': 'sender@email.com',\n  'to': 'recipient@email.com',\n  'date': 'Email Date',\n  'messageId': 'unique_message_id_string'\n}\"\n";
-export declare const GET_THREAD_DESCRIPTION = "A tool for retrieving an entire email thread from Gmail using the thread ID.\n\nINPUT example:\n{\n  \"threadId\": \"unique_thread_id_string\"\n}\n\nOUTPUT:\nThe output includes an array of all the messages in the specified thread. Each message in the array contains detailed information including the subject, body, sender (from), recipients (to), date of the email, and the message ID. If any of these details are not available in a message, the tool will throw an error indicating the missing information.\n\nExample Output:\n\"Result for the prompt unique_thread_id_string\n[\n  {\n    'subject': 'Email Subject',\n    'body': 'Email Body Content',\n    'from': 'sender@email.com',\n    'to': 'recipient@email.com',\n    'date': 'Email Date',\n    'messageId': 'unique_message_id_string'\n  },\n  ... (other messages in the thread)\n]\"\n";
-export declare const SEND_MESSAGE_DESCRIPTION = "A tool for sending an email message using Gmail. It allows users to specify recipients, subject, and the content of the message, along with optional cc and bcc fields.\n\nINPUT example:\n{\n  \"message\": \"Hello, this is a test email\",\n  \"to\": [\"recipient1@email.com\", \"recipient2@email.com\"],\n  \"subject\": \"Test Email\",\n  \"cc\": [\"cc1@email.com\"],\n  \"bcc\": [\"bcc1@email.com\"]\n}\n\nOUTPUT:\nThe output is a confirmation message with the ID of the sent email. If there is an error during the sending process, the tool will throw an error with a description of the problem.\n\nExample Output:\n\"Message sent. Message Id: unique_message_id_string\"\n";
-export declare const SEARCH_DESCRIPTION = "A tool for searching email messages or threads in Gmail using a specific query. It offers the flexibility to choose between messages and threads as the search resource.\n\nINPUT example:\n{\n  \"query\": \"specific search query\",\n  \"maxResults\": 10, // Optional: number of results to return\n  \"resource\": \"messages\" // Optional: can be \"messages\" or \"threads\"\n}\n\nOUTPUT:\nThe output is a JSON list of either email messages or threads, depending on the specified resource, that matches the search query. For 'messages', the output includes details like the message ID, thread ID, snippet, body, subject, and sender of each message. For 'threads', it includes the thread ID, snippet, body, subject, and sender of the first message in each thread. If no data is returned, or if the specified resource is invalid, the tool throws an error with a relevant message.\n\nExample Output for 'messages':\n\"Result for the query 'specific search query':\n[\n  {\n    'id': 'message_id',\n    'threadId': 'thread_id',\n    'snippet': 'message snippet',\n    'body': 'message body',\n    'subject': 'message subject',\n    'sender': 'sender's email'\n  },\n  ... (other messages matching the query)\n]\"\n\nExample Output for 'threads':\n\"Result for the query 'specific search query':\n[\n  {\n    'id': 'thread_id',\n    'snippet': 'thread snippet',\n    'body': 'first message body',\n    'subject': 'first message subject',\n    'sender': 'first message sender'\n  },\n  ... (other threads matching the query)\n]\"\n";