@zackbart/connecta 0.34.1 → 0.36.0

package/dist/providers/gmail/lib/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Gmail's API root, confined to the delegated user's own mailbox: `me` is the
+ * token's subject, and no path can climb out of it.
+ */
+export declare const GMAIL_API_BASE_URL = "https://gmail.googleapis.com/gmail/v1/users/me";
+/**
+ * Exactly the scopes this connection requests, and exactly what the Admin
+ * console's domain-wide delegation entry must list (comma-separated there).
+ * `gmail.compose` technically permits sending; the tool surface does not.
+ */
+export declare const GMAIL_SCOPES: readonly ["https://www.googleapis.com/auth/gmail.readonly", "https://www.googleapis.com/auth/gmail.compose"];
+/** A full thread without attachment bodies; Gmail's message cap is 25 MB. */
+export declare const GMAIL_MAX_RESPONSE_BYTES: number;

package/dist/providers/gmail/lib/constants.js

@@ -0,0 +1,16 @@
+/**
+ * Gmail's API root, confined to the delegated user's own mailbox: `me` is the
+ * token's subject, and no path can climb out of it.
+ */
+export const GMAIL_API_BASE_URL = "https://gmail.googleapis.com/gmail/v1/users/me";
+/**
+ * Exactly the scopes this connection requests, and exactly what the Admin
+ * console's domain-wide delegation entry must list (comma-separated there).
+ * `gmail.compose` technically permits sending; the tool surface does not.
+ */
+export const GMAIL_SCOPES = [
+    "https://www.googleapis.com/auth/gmail.readonly",
+    "https://www.googleapis.com/auth/gmail.compose",
+];
+/** A full thread without attachment bodies; Gmail's message cap is 25 MB. */
+export const GMAIL_MAX_RESPONSE_BYTES = 16 * 1024 * 1024;

package/dist/providers/gmail/lib/index.js

@@ -0,0 +1,173 @@
+// Reviewed frozen Gmail v1 inventory: 79 indexed keys, eleven executable reads.
+import { OperationIndex } from "../../_shared/rest/operation-index.js";
+import { googlePageToken } from "../../../http/hatch-paging.js";
+import { openapi } from "../openapi.generated.js";
+export const index = new OperationIndex(openapi, { vendor: "gmail", title: "Gmail", pathMatching: "uri-template" });
+export const verdicts = {
+    "GET /drafts": "read",
+    "POST /drafts": "refuse",
+    "POST /drafts/send": "refuse",
+    "DELETE /drafts/{id}": "refuse",
+    "GET /drafts/{id}": "read",
+    "PUT /drafts/{id}": "refuse",
+    "GET /history": "read",
+    "GET /labels": "read",
+    "POST /labels": "refuse",
+    "DELETE /labels/{id}": "refuse",
+    "GET /labels/{id}": "read",
+    "PATCH /labels/{id}": "refuse",
+    "PUT /labels/{id}": "refuse",
+    "GET /messages": "read",
+    "POST /messages": "refuse",
+    "POST /messages/batchDelete": "refuse",
+    "POST /messages/batchModify": "refuse",
+    "POST /messages/import": "refuse",
+    "POST /messages/send": "refuse",
+    "DELETE /messages/{id}": "refuse",
+    "GET /messages/{id}": "read",
+    "POST /messages/{id}/modify": "refuse",
+    "POST /messages/{id}/trash": "refuse",
+    "POST /messages/{id}/untrash": "refuse",
+    "GET /messages/{messageId}/attachments/{id}": "read",
+    "GET /profile": "read",
+    "GET /settings/autoForwarding": "refuse",
+    "PUT /settings/autoForwarding": "refuse",
+    "GET /settings/cse/identities": "refuse",
+    "POST /settings/cse/identities": "refuse",
+    "DELETE /settings/cse/identities/{cseEmailAddress}": "refuse",
+    "GET /settings/cse/identities/{cseEmailAddress}": "refuse",
+    "PATCH /settings/cse/identities/{emailAddress}": "refuse",
+    "GET /settings/cse/keypairs": "refuse",
+    "POST /settings/cse/keypairs": "refuse",
+    "GET /settings/cse/keypairs/{keyPairId}": "refuse",
+    "POST /settings/cse/keypairs/{keyPairId}:disable": "refuse",
+    "POST /settings/cse/keypairs/{keyPairId}:enable": "refuse",
+    "POST /settings/cse/keypairs/{keyPairId}:obliterate": "refuse",
+    "GET /settings/delegates": "refuse",
+    "POST /settings/delegates": "refuse",
+    "DELETE /settings/delegates/{delegateEmail}": "refuse",
+    "GET /settings/delegates/{delegateEmail}": "refuse",
+    "GET /settings/filters": "refuse",
+    "POST /settings/filters": "refuse",
+    "DELETE /settings/filters/{id}": "refuse",
+    "GET /settings/filters/{id}": "refuse",
+    "GET /settings/forwardingAddresses": "refuse",
+    "POST /settings/forwardingAddresses": "refuse",
+    "DELETE /settings/forwardingAddresses/{forwardingEmail}": "refuse",
+    "GET /settings/forwardingAddresses/{forwardingEmail}": "refuse",
+    "GET /settings/imap": "refuse",
+    "PUT /settings/imap": "refuse",
+    "GET /settings/language": "refuse",
+    "PUT /settings/language": "refuse",
+    "GET /settings/pop": "refuse",
+    "PUT /settings/pop": "refuse",
+    "GET /settings/sendAs": "refuse",
+    "POST /settings/sendAs": "refuse",
+    "DELETE /settings/sendAs/{sendAsEmail}": "refuse",
+    "GET /settings/sendAs/{sendAsEmail}": "refuse",
+    "PATCH /settings/sendAs/{sendAsEmail}": "refuse",
+    "PUT /settings/sendAs/{sendAsEmail}": "refuse",
+    "GET /settings/sendAs/{sendAsEmail}/smimeInfo": "refuse",
+    "POST /settings/sendAs/{sendAsEmail}/smimeInfo": "refuse",
+    "DELETE /settings/sendAs/{sendAsEmail}/smimeInfo/{id}": "refuse",
+    "GET /settings/sendAs/{sendAsEmail}/smimeInfo/{id}": "refuse",
+    "POST /settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault": "refuse",
+    "POST /settings/sendAs/{sendAsEmail}/verify": "refuse",
+    "GET /settings/vacation": "refuse",
+    "PUT /settings/vacation": "refuse",
+    "POST /stop": "refuse",
+    "GET /threads": "read",
+    "DELETE /threads/{id}": "refuse",
+    "GET /threads/{id}": "read",
+    "POST /threads/{id}/modify": "refuse",
+    "POST /threads/{id}/trash": "refuse",
+    "POST /threads/{id}/untrash": "refuse",
+    "POST /watch": "refuse",
+};
+export const named = {
+    "GET /threads": "search_threads",
+    "GET /threads/{id}": "get_thread",
+    "GET /messages/{id}": "get_message",
+    "GET /messages/{messageId}/attachments/{id}": "get_attachment",
+    "GET /labels": "list_labels",
+    "GET /drafts": "list_drafts",
+    "GET /drafts/{id}": "get_draft",
+    "POST /drafts": "create_draft",
+    "PUT /drafts/{id}": "update_draft",
+};
+export const pages = {
+    "GET /threads": googlePageToken,
+    "GET /messages": googlePageToken,
+    "GET /drafts": googlePageToken,
+    "GET /history": googlePageToken,
+};
+export const refusalReasons = {
+    "POST /drafts": "Draft writes are available only through create_draft, which builds guarded reply MIME.",
+    "POST /drafts/send": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "DELETE /drafts/{id}": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "PUT /drafts/{id}": "Draft writes are available only through update_draft, which preserves headers and refuses attachments.",
+    "POST /labels": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "DELETE /labels/{id}": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "PATCH /labels/{id}": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "PUT /labels/{id}": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /messages": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /messages/batchDelete": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /messages/batchModify": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /messages/import": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /messages/send": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "DELETE /messages/{id}": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /messages/{id}/modify": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /messages/{id}/trash": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /messages/{id}/untrash": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "GET /settings/autoForwarding": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "PUT /settings/autoForwarding": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/cse/identities": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "POST /settings/cse/identities": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "DELETE /settings/cse/identities/{cseEmailAddress}": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/cse/identities/{cseEmailAddress}": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "PATCH /settings/cse/identities/{emailAddress}": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/cse/keypairs": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "POST /settings/cse/keypairs": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/cse/keypairs/{keyPairId}": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "POST /settings/cse/keypairs/{keyPairId}:disable": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "POST /settings/cse/keypairs/{keyPairId}:enable": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "POST /settings/cse/keypairs/{keyPairId}:obliterate": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/delegates": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "POST /settings/delegates": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "DELETE /settings/delegates/{delegateEmail}": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/delegates/{delegateEmail}": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/filters": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "POST /settings/filters": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "DELETE /settings/filters/{id}": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/filters/{id}": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/forwardingAddresses": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "POST /settings/forwardingAddresses": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "DELETE /settings/forwardingAddresses/{forwardingEmail}": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/forwardingAddresses/{forwardingEmail}": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/imap": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "PUT /settings/imap": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/language": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "PUT /settings/language": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/pop": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "PUT /settings/pop": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "GET /settings/sendAs": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "POST /settings/sendAs": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "DELETE /settings/sendAs/{sendAsEmail}": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "GET /settings/sendAs/{sendAsEmail}": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "PATCH /settings/sendAs/{sendAsEmail}": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "PUT /settings/sendAs/{sendAsEmail}": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "GET /settings/sendAs/{sendAsEmail}/smimeInfo": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "POST /settings/sendAs/{sendAsEmail}/smimeInfo": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "DELETE /settings/sendAs/{sendAsEmail}/smimeInfo/{id}": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "GET /settings/sendAs/{sendAsEmail}/smimeInfo/{id}": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "POST /settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "POST /settings/sendAs/{sendAsEmail}/verify": "Sending is never available; use create_draft or update_draft to save a draft for review in Gmail.",
+    "GET /settings/vacation": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "PUT /settings/vacation": "Mailbox settings, forwarding, delegation, CSE and S/MIME are outside this draft-only connection; use create_draft or update_draft for drafts.",
+    "POST /stop": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "DELETE /threads/{id}": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /threads/{id}/modify": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /threads/{id}/trash": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /threads/{id}/untrash": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+    "POST /watch": "This operation is outside the reviewed read allowlist; use create_draft or update_draft for draft writes. Sending is never available.",
+};

package/dist/providers/gmail/lib/schemas.js

@@ -0,0 +1,176 @@
+// Real Effect declarations for Gmail's curated surface. MIME interpretation stays in tools.ts.
+import { Schema } from "effect";
+import { Integer, isMinChars, isMaxChars } from "../../../http/json-schema.js";
+import { StandardPage } from "../../../http/paging.js";
+import { fieldsInput } from "../../../http/fields.js";
+const optional = Schema.optionalKey;
+const pattern = (regex) => Schema.makeFilter((value) => regex.test(value), { toJsonSchema: () => ({ pattern: regex.source }) });
+const string = (description, max, min = 0) => Schema.String.check(isMinChars(min), isMaxChars(max)).annotate({ description });
+const id = (description) => string(description, 256, 1).check(pattern(/^[A-Za-z0-9_-]+$/));
+const cursor = optional(string("Opaque page.nextCursor from the same call. Pass it back unchanged.", 4096, 1));
+const limit = optional(Integer.check(Schema.isBetween({ minimum: 1, maximum: 25 })).annotate({
+    default: 10,
+    description: "Rows per page, default 10, at most 25. Each summary costs a metadata read.",
+}));
+const query = optional(string("Gmail search syntax: from:, subject:, label:, is:unread, newer_than:7d. Omit for everything.", 2048));
+const bodyChars = (value) => optional(Integer.check(Schema.isBetween({ minimum: 0, maximum: 100000 })).annotate({
+    default: value,
+    description: "Body characters kept per message; size cuts appear in truncated.",
+}));
+const recipients = (description) => optional(Schema.Array(string("Address or Name <address@example.com>.", 320, 3).check(pattern(/^[^\r\n]*$/)))
+    .check(Schema.isMaxLength(100))
+    .annotate({ description }));
+const compose = {
+    to: recipients("To recipients; replies default to Reply-To, else From."),
+    cc: recipients("Cc recipients."),
+    bcc: recipients("Bcc recipients."),
+    subject: optional(string("Subject; replies default to Re: and the original subject.", 900).check(pattern(/^[^\r\n]*$/))),
+    body: string("Full new plain-text body.", 200000),
+    htmlBody: optional(string("Optional HTML alternative to the plain-text body.", 500000)),
+    replyToMessageId: optional(id("Message to reply to; sets its thread and guarded In-Reply-To/References.")),
+};
+const resultFields = optional(fieldsInput("Dot paths to keep in the result. It only narrows the result."));
+const itemFields = optional(fieldsInput("Dot paths to keep in each item. It only narrows the projection."));
+export const inputs = {
+    search_threads: Schema.Struct({
+        query,
+        includeSpamTrash: optional(Schema.Boolean),
+        limit,
+        cursor,
+        fields: itemFields,
+    }),
+    get_thread: Schema.Struct({
+        threadId: id("Thread id from search_threads or a message."),
+        maxBodyChars: bodyChars(3000),
+        cursor,
+        fields: resultFields,
+    }),
+    get_message: Schema.Struct({
+        messageId: id("Message id from a thread or draft."),
+        maxBodyChars: bodyChars(12000),
+        fields: resultFields,
+    }),
+    get_attachment: Schema.Struct({
+        fields: resultFields,
+        messageId: id("Message carrying the attachment."),
+        partId: optional(string("Immutable partId from the attachment listing, including an empty root id. Takes precedence over attachmentId.", 256)),
+        attachmentId: optional(string("Alternative rotating attachmentId from a fresh listing; prefer partId.", 2048, 1).check(pattern(/^[A-Za-z0-9_-]+$/))),
+        maxChars: optional(Integer.check(Schema.isBetween({ minimum: 1, maximum: 100000 })).annotate({
+            default: 12000,
+            description: "Text code points kept; ignored for binaries.",
+        })),
+        maxBytes: optional(Integer.check(Schema.isBetween({ minimum: 65536, maximum: 4194304 })).annotate({
+            default: 196608,
+            description: "Whole-result byte budget. Raise only for a direct call_tool; execute_code cannot receive large results.",
+        })),
+    }),
+    list_labels: Schema.Struct({ fields: itemFields }),
+    list_drafts: Schema.Struct({ query, limit, cursor, fields: itemFields }),
+    get_draft: Schema.Struct({
+        fields: resultFields,
+        draftId: id("Stable draft id from list_drafts or create_draft."),
+        maxBodyChars: bodyChars(12000),
+    }),
+    create_draft: Schema.Struct(compose),
+    update_draft: Schema.Struct({
+        draftId: id("Draft to replace; attachments and inline images are refused."),
+        ...compose,
+    }),
+};
+const loose = (fields) => Schema.Struct(Object.fromEntries(Object.entries(fields).map(([key, value]) => [key, optional(value)])));
+const truncated = optional(Schema.Array(Schema.String));
+const Attachment = loose({
+    filename: Schema.String,
+    mimeType: Schema.String,
+    size: Integer,
+    attachmentId: Schema.String,
+    partId: Schema.String,
+});
+const messageFields = {
+    id: Schema.String,
+    threadId: Schema.String,
+    labelIds: Schema.Array(Schema.String),
+    date: Schema.String,
+    from: Schema.String,
+    to: Schema.String,
+    cc: Schema.String,
+    bcc: Schema.String,
+    replyTo: Schema.String,
+    subject: Schema.String,
+    messageIdHeader: Schema.String,
+    inReplyTo: Schema.String,
+    snippet: Schema.String,
+    body: Schema.String,
+    bodyFormat: Schema.Literals(["text", "html", "none", "unavailable"]),
+    bodyNote: Schema.String,
+    attachments: Schema.Array(Attachment),
+};
+const Message = loose(messageFields);
+const { id: _id, ...draftFields } = messageFields;
+export const rows = {
+    search_threads: loose({
+        id: Schema.String,
+        subject: Schema.String,
+        from: Schema.String,
+        lastFrom: Schema.String,
+        messageCount: Integer,
+        lastMessageAt: Schema.String,
+        unread: Schema.Boolean,
+        labelIds: Schema.Array(Schema.String),
+        snippet: Schema.String,
+    }),
+    list_labels: loose({ id: Schema.String, name: Schema.String, type: Schema.Literals(["system", "user"]) }),
+    list_drafts: loose({
+        draftId: Schema.String,
+        messageId: Schema.String,
+        threadId: Schema.String,
+        subject: Schema.String,
+        to: Schema.String,
+        updatedAt: Schema.String,
+        snippet: Schema.String,
+    }),
+};
+const listOutput = (row) => Schema.Struct({ items: Schema.Array(row), page: StandardPage, truncated });
+const Saved = Schema.Struct({
+    draftId: optional(Schema.String),
+    messageId: optional(Schema.String),
+    threadId: optional(Schema.String),
+    saved: Schema.Literal(true),
+    sent: Schema.Literal(false),
+    note: optional(Schema.String),
+    truncated,
+});
+export const outputs = {
+    search_threads: listOutput(rows.search_threads),
+    list_labels: Schema.Struct({
+        items: Schema.Array(rows.list_labels),
+        page: Schema.Struct({ hasMore: Schema.Literal(false) }),
+        truncated,
+    }),
+    list_drafts: listOutput(rows.list_drafts),
+    get_thread: loose({
+        id: Schema.String,
+        messageCount: Integer,
+        messages: Schema.Array(Message),
+        page: loose({ hasMore: Schema.Boolean, nextCursor: Schema.String }),
+        truncated: Schema.Array(Schema.String),
+    }),
+    get_message: Schema.Struct({ ...Message.fields, truncated }),
+    get_draft: Schema.Struct({
+        ...loose({ draftId: Schema.String, messageId: Schema.String, ...draftFields }).fields,
+        truncated,
+    }),
+    get_attachment: loose({
+        messageId: Schema.String,
+        partId: Schema.String,
+        filename: Schema.String,
+        mimeType: Schema.String,
+        size: Integer,
+        format: Schema.Literals(["text", "base64", "unavailable"]),
+        content: Schema.String,
+        note: Schema.String,
+        truncated: Schema.Array(Schema.String),
+    }),
+    create_draft: Saved,
+    update_draft: Saved,
+};

package/dist/providers/gmail/lib/threading.js

@@ -0,0 +1,120 @@
+import { ConnectorCallError } from "../../../errors.js";
+/** RFC 5322 sections 3.6.4/4.5.4, with H8's stricter ASCII/control boundary. */
+export function threadingIds(value, legacyPhrases = false) {
+    if (value === undefined)
+        return [];
+    const fail = () => {
+        throw new ConnectorCallError("invalid_args", "The copied Message-ID, In-Reply-To or References header is malformed or withheld. No draft was changed; repair its threading in Gmail.");
+    };
+    // Unfold before parsing; a bare CR/LF, control, non-ASCII or withheld lane
+    // must never become a different, apparently usable threading token.
+    const source = value.replace(/\r\n(?=[ \t])/g, "");
+    if (value.length > 32768 || !/^[\x20-\x7e\t]*$/.test(source) || source.includes("[redacted]"))
+        fail();
+    let at = 0;
+    const atom = () => {
+        const start = at;
+        while (at < source.length && /[A-Za-z0-9!#$%&'*+\-/=?^_`{|}~]/.test(source[at]))
+            at++;
+        if (at === start)
+            fail();
+    };
+    const quoted = (close) => {
+        at++;
+        while (at < source.length) {
+            const character = source[at++];
+            if (character === close)
+                return;
+            if (character === "\\") {
+                if (at === source.length)
+                    fail();
+                at++;
+            }
+            else if (close === "]" && character === "[")
+                fail();
+        }
+        fail();
+    };
+    const cfws = () => {
+        while (at < source.length) {
+            if (source[at] === " " || source[at] === "\t")
+                at++;
+            else if (source[at] === "(") {
+                let depth = 1;
+                at++;
+                while (depth && at < source.length) {
+                    const character = source[at++];
+                    if (character === "\\") {
+                        if (at === source.length)
+                            fail();
+                        at++;
+                    }
+                    else if (character === "(")
+                        depth++;
+                    else if (character === ")")
+                        depth--;
+                }
+                if (depth)
+                    fail();
+            }
+            else
+                return;
+        }
+    };
+    const word = () => {
+        if (source[at] === '"')
+            quoted('"');
+        else
+            atom();
+    };
+    const side = (left) => {
+        cfws();
+        if (!left && source[at] === "[")
+            quoted("]");
+        else {
+            if (left)
+                word();
+            else
+                atom();
+            cfws();
+            while (source[at] === ".") {
+                at++;
+                cfws();
+                if (left)
+                    word();
+                else
+                    atom();
+                cfws();
+            }
+        }
+        cfws();
+    };
+    const ids = [];
+    while (at < source.length) {
+        cfws();
+        if (at === source.length)
+            break;
+        if (source[at] === "<") {
+            const start = at++;
+            side(true);
+            if (source[at++] !== "@")
+                fail();
+            side(false);
+            if (source[at++] !== ">")
+                fail();
+            const id = source.slice(start, at);
+            if (id.length > 998)
+                fail();
+            ids.push(id);
+        }
+        else if (legacyPhrases && (source[at] === "," || source[at] === "."))
+            at++;
+        else if (legacyPhrases)
+            word();
+        else
+            fail();
+    }
+    if (!legacyPhrases && ids.length !== 1)
+        fail();
+    return ids;
+}