@particle-academy/gmail-inbox-ui 0.0.0 → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog — Gmail Inbox
+
+All four packages — `@particle-academy/gmail-inbox-ui`, `@particle-academy/gmail-inbox-js`,
+`particle-academy/gmail-inbox-php` and `fancy-gmail-inbox` — are released together
+under one version. They are generated from one `provider/` definition, so a
+change to it changes all four, and separate version lines would only record
+which of the four somebody remembered to bump.
+
+**Write entries HERE**, in the weaver envelope at `providers/gmail-inbox/CHANGELOG.md`,
+then regenerate. This file is the one thing in a release that cannot be
+derived — somebody has to write what changed — but writing it in the
+provider repo would be a hand-edit that `.weaver.json` flags and the next
+sync destroys.
+
+## [0.1.0] — 2026-10-01
+
+### Added
+
+- **First release.** `message_list` (search, label filter, pagination),
+  `message_get`, `thread_get`, `label_list`. OAuth2 with `gmail.readonly`.
+- **A SEPARATE connector from `gmail`, by design, not a scope widening of
+  it.** `gmail.readonly` is a RESTRICTED Google OAuth scope requiring an
+  annual CASA security assessment on the app that requests it, and
+  Google's verification is per OAUTH CLIENT — attaching it to `gmail`'s
+  own client would have put the recurring assessment on every existing
+  send-only consumer. A second connector, a second OAuth client, puts it
+  only where it is actually needed. Part of the owner's Google Workspace
+  commission (Tynn #19) — Fancy's own compliance audit found this before
+  any code was written, and the split was decided before this connector
+  existed.
+- `message_get` and `thread_get` publish `payload.headers` (From, To,
+  Subject, Date, unparsed) and Gmail's own `snippet` preview, but do NOT
+  decode the MIME body tree — `payload.parts` can nest arbitrarily for a
+  multipart message, and flattening it to plain text/HTML is real parsing
+  work this connector does not do yet. The raw `payload` is still
+  published for a host that wants to decode it. Noted rather than
+  rushed, the same shape as Drive's deferred file upload.
+- Gmail has no sandbox — every read reaches the connected account's real
+  mailbox. The faker is the only way to develop against it without doing
+  that.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Particle Academy
+
+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.

package/README.md

@@ -1,3 +1,138 @@
-# @particle-academy/gmail-inbox-ui
+# Gmail Inbox
 
-**0.0.0 claims the name and ships nothing.** It exists so a Trusted Publisher can be attached to the package; the first real release is published from https://github.com/Fancy-Friends/gmail-inbox by its `publish.yml` workflow with provenance, and this version is deprecated the moment it lands.
+[![Fancified](art/fancified.svg)](https://particle.academy)
+
+Gmail Inbox for [fancy-flow][flow] — as **four imported, versioned packages**, one
+per runtime. Not vendored source: a copy cannot be upgraded, and third-party APIs
+change.
+
+[flow]: https://github.com/Particle-Academy/fancy-flow
+
+| Runtime | Package | Install |
+|---|---|---|
+| Authoring surface (every host) | `@particle-academy/gmail-inbox-ui` | `npm install @particle-academy/gmail-inbox-ui` |
+| Node | `@particle-academy/gmail-inbox-js` | `npm install @particle-academy/gmail-inbox-js` |
+| PHP 8.4+ | `particle-academy/gmail-inbox-php` | `composer require particle-academy/gmail-inbox-php` |
+| Python 3.11+ | `fancy-gmail-inbox` | `pip install fancy-gmail-inbox` |
+
+The `ui` package is the editor surface and is React on every host — a PHP or
+Python project installs it *and* its own runtime package, and never the `js` one.
+
+## What it costs you
+
+One dependency: `@particle-academy/fancy-connector-core` (or
+`particle-academy/fancy-connector-core` on Composer), which the `js` and `php`
+packages pull in themselves. The Python package has **zero** runtime
+dependencies.
+
+**No Gmail Inbox SDK.** Plain HTTP, deliberately: a vendor SDK is third-party code
+subject to the kit's full approval bar, and one per provider is hundreds of
+dependencies nobody is tracking.
+
+## Setting it up
+
+Everything below is generated from `provider/manifest.json`, so it cannot disagree with what the packages do.
+
+### Credentials
+
+A Gmail Inbox connection holds 4 values.
+
+**Two kinds of value, and mixing them up matters.** A `provider` credential is ONE value for the whole installation — an OAuth app's client secret serves every connected account. An `account` credential is one per connected account. A host that stores the second where it stores the first lets one account's credentials reach another's.
+
+| Field | Scope | Secret | Where it comes from |
+|---|---|---|---|
+| **OAuth client ID** | per installation | not secret | A DIFFERENT OAuth app than `gmail`'s, from Google Cloud Console -> APIs & Services -> Credentials. This one requests a restricted scope and carries Google's annual CASA assessment; `gmail`'s does not. Do not reuse the same client for both. |
+| **OAuth client secret** | per installation | **secret** | The client secret for the same OAuth app. One value for the whole installation. |
+| **Access token** | per connected account | **secret** | Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token. |
+| **Refresh token** | per connected account | **secret** | Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour. |
+
+### Authorising
+
+Gmail Inbox uses OAuth2 (authorization_code). The package DECLARES the exchange; the HOST performs it — a consent screen needs a browser, a redirect URI and somewhere to persist the result, and all three belong to the host.
+
+- **Authorize URL** — https://accounts.google.com/o/oauth2/v2/auth
+- **Token URL** — https://oauth2.googleapis.com/token
+- **Scopes** — `https://www.googleapis.com/auth/gmail.readonly`
+- **Access token lifetime** — 3600 seconds (1 hours). A host that never refreshes works all afternoon and is broken by morning.
+
+The refresh tokens do **not** rotate: the same one is reusable, so a refresh may safely be retried and may run concurrently. Stated rather than assumed, because the opposite — a provider that spends the token and revokes the grant on a replay — looks identical until it happens.
+
+### The estate
+
+**Gmail Inbox has no test estate, and somebody checked.** Everything this connector does is real. Use the faker to build against it.
+
+> Gmail has no sandbox. Every read reaches the connected account's real mail. The faker is the only way to develop against it without touching a real mailbox.
+
+## What it can do
+
+### Actions
+
+#### `label_list` — List Gmail labels
+
+List every label on the mailbox, system and user-created.
+
+`GET /gmail/v1/users/{userId}/labels` · reads only — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `userId` | yes | Mailbox |
+
+#### `message_get` — Gmail message
+
+Read one message's headers and preview. The body's plain/HTML text is NOT decoded -- see the raw payload for that.
+
+`GET /gmail/v1/users/{userId}/messages/{id}` · reads only — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `userId` | yes | Mailbox |
+| `id` | yes | From message_list, or another node's output. |
+
+#### `message_list` — List Gmail messages
+
+List message ids matching a search, newest first.
+
+`GET /gmail/v1/users/{userId}/messages` · reads only — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `userId` | yes | `me` is the connected account and is almost always what you want. |
+| `q` | no | Gmail's own search syntax, exactly as typed into the Gmail search box -- e.g. "from:ada@example.test has:attachment newer_than:7d". Leave blank to list everything. |
+| `labelId` | no | Only messages with this label -- e.g. INBOX, or a label_list id. Gmail's own query parameter accepts several, repeated; this connector offers one for now -- combine more in the search field above instead, using Gmail's own label: search operator. |
+| `includeSpamTrash` | no | Include spam and trash |
+| `maxResults` | no | Gmail's own maximum is 500. |
+| `pageToken` | no | From a previous page's nextPageToken. |
+
+#### `thread_get` — Gmail thread
+
+Read every message in a conversation thread, oldest first.
+
+`GET /gmail/v1/users/{userId}/threads/{id}` · reads only — safe to replay
+
+| Input | Required | What it is |
+|---|---|---|
+| `userId` | yes | Mailbox |
+| `id` | yes | A message's threadId, from message_list or message_get. |
+
+## Run it before you have credentials
+
+Every operation ships a **faker**, whether or not Gmail Inbox has a sandbox. Set a
+node's mode to `fake` and it returns the shape Gmail Inbox actually publishes — the
+same field names, deterministically — so you can wire the downstream nodes before
+touching an account, a key, or a network.
+
+## This repository is generated
+
+`provider/` is the source. Everything under `packages/` is emitted from it and
+**must not be hand-edited** — CI regenerates and diffs on every push, and the
+next protocol sync destroys anything it finds. See [`AGENTS.md`](AGENTS.md).
+
+## Two namespaces, which do not match on purpose
+
+The repo is `github.com/Fancy-Friends/gmail-inbox`; the packages publish under
+`particle-academy`. Nothing derives one from the other — the names come from
+weaver's `friends.json` and nowhere else.
+
+## Licence
+
+MIT.

package/art/fancified.svg

@@ -0,0 +1,26 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="28" role="img" aria-label="Fancified — built with Fancy UI">
+  <title>Fancified · built with Fancy UI</title>
+  <defs>
+    <linearGradient id="fcdBg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#6d28d9"/>
+      <stop offset=".5" stop-color="#9333ea"/>
+      <stop offset="1" stop-color="#d946ef"/>
+    </linearGradient>
+    <linearGradient id="fcdGloss" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#ffffff" stop-opacity=".30"/>
+      <stop offset=".55" stop-color="#ffffff" stop-opacity="0"/>
+    </linearGradient>
+    <clipPath id="fcdClip"><rect width="128" height="28" rx="7"/></clipPath>
+  </defs>
+  <g clip-path="url(#fcdClip)">
+    <rect width="128" height="28" fill="url(#fcdBg)"/>
+    <rect width="34" height="28" fill="#3b0764" fill-opacity=".5"/>
+    <rect width="128" height="13" fill="url(#fcdGloss)"/>
+    <g fill="#fff">
+      <path transform="translate(17 14)" d="M0 -7 C.6 -2.2 2.2 -.6 7 0 C2.2 .6 .6 2.2 0 7 C-.6 2.2 -2.2 .6 -7 0 C-2.2 -.6 -.6 -2.2 0 -7 Z"/>
+      <path transform="translate(25.5 7.5) scale(.34)" fill-opacity=".85" d="M0 -7 C.6 -2.2 2.2 -.6 7 0 C2.2 .6 .6 2.2 0 7 C-.6 2.2 -2.2 .6 -7 0 C-2.2 -.6 -.6 -2.2 0 -7 Z"/>
+    </g>
+    <text x="81" y="18.5" fill="#ffffff" text-anchor="middle" font-family="'Segoe UI',Verdana,'DejaVu Sans',sans-serif" font-size="12" font-weight="700" letter-spacing=".3">Fancified</text>
+  </g>
+  <rect x=".5" y=".5" width="127" height="27" rx="6.5" fill="none" stroke="#ffffff" stroke-opacity=".22"/>
+</svg>

package/dist/index.cjs

@@ -0,0 +1,339 @@
+'use strict';
+
+var connectors = require('@particle-academy/fancy-flow/connectors');
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var GMAIL_INBOX_SERVICE = {
+  service: "gmail_inbox",
+  serviceTitle: "Gmail Inbox",
+  domain: "email",
+  sandbox: "none"
+};
+var GMAIL_INBOX_CREDENTIALS = [
+  {
+    "key": "clientId",
+    "label": "OAuth client ID",
+    "scope": "provider",
+    "secret": false,
+    "help": "A DIFFERENT OAuth app than `gmail`'s, from Google Cloud Console -> APIs & Services -> Credentials. This one requests a restricted scope and carries Google's annual CASA assessment; `gmail`'s does not. Do not reuse the same client for both."
+  },
+  {
+    "key": "clientSecret",
+    "label": "OAuth client secret",
+    "scope": "provider",
+    "secret": true,
+    "help": "The client secret for the same OAuth app. One value for the whole installation."
+  },
+  {
+    "key": "accessToken",
+    "label": "Access token",
+    "scope": "account",
+    "secret": true,
+    "help": "Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token."
+  },
+  {
+    "key": "refreshToken",
+    "label": "Refresh token",
+    "scope": "account",
+    "secret": true,
+    "help": "Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour."
+  }
+];
+var GMAIL_INBOX_OAUTH = {
+  "flow": "authorization_code",
+  "authorizeUrl": "https://accounts.google.com/o/oauth2/v2/auth",
+  "tokenUrl": "https://oauth2.googleapis.com/token",
+  "scopes": [
+    "https://www.googleapis.com/auth/gmail.readonly"
+  ],
+  "accessTokenCredential": "accessToken",
+  "refreshTokenCredential": "refreshToken",
+  "refreshTokenRotates": false,
+  "accessTokenTtlSeconds": 3600
+};
+function gmailInboxMeta(role, operation, docs) {
+  return { ...GMAIL_INBOX_SERVICE, role, operation, docs };
+}
+var GMAIL_INBOX_LABEL_LIST_KIND = "@particle-academy/gmail_inbox_label_list";
+var GMAIL_INBOX_LABEL_LIST_OPERATION = "label_list";
+var GMAIL_INBOX_LABEL_LIST_META = gmailInboxMeta("action", "list labels", "https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.labels/list");
+var GMAIL_INBOX_LABEL_LIST_OUTPUT = [
+  {
+    "path": "data.labels",
+    "type": "array",
+    "description": "Each with id, name and type (system or user). messagesTotal/messagesUnread/threadsTotal/threadsUnread are part of Label's schema but not confirmed present on every list row -- read one label with labels.get if a count comes back missing."
+  }
+];
+var gmailInboxLabelListKind = connectors.defineConnectorKind(GMAIL_INBOX_LABEL_LIST_META, {
+  name: GMAIL_INBOX_LABEL_LIST_KIND,
+  aliases: ["gmail_inbox_label_list"],
+  label: "List Gmail labels",
+  description: "List every label on the mailbox, system and user-created.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GMAIL_INBOX_LABEL_LIST_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "userId",
+      "label": "Mailbox",
+      "required": true,
+      "default": "me"
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => connectors.summarize(GMAIL_INBOX_LABEL_LIST_META, config, "list labels")
+});
+var GMAIL_INBOX_MESSAGE_GET_KIND = "@particle-academy/gmail_inbox_message_get";
+var GMAIL_INBOX_MESSAGE_GET_OPERATION = "message_get";
+var GMAIL_INBOX_MESSAGE_GET_META = gmailInboxMeta("action", "read a message", "https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/get");
+var GMAIL_INBOX_MESSAGE_GET_OUTPUT = [
+  {
+    "path": "data.id",
+    "type": "string",
+    "description": "The message id."
+  },
+  {
+    "path": "data.threadId",
+    "type": "string",
+    "description": "The thread this message belongs to."
+  },
+  {
+    "path": "data.labelIds",
+    "type": "array",
+    "description": "System and user label ids currently on this message."
+  },
+  {
+    "path": "data.snippet",
+    "type": "string",
+    "description": "Gmail's own short plain-text preview of the body -- a few hundred characters, not the whole message."
+  },
+  {
+    "path": "data.internalDate",
+    "type": "string",
+    "description": "Unix epoch MILLISECONDS, as a string -- when Gmail received it, which can differ from the Date header."
+  },
+  {
+    "path": "data.payload.headers",
+    "type": "array",
+    "description": "Every RFC 2822 header as { name, value }, unparsed. From/To/Subject/Date live here."
+  },
+  {
+    "path": "data.payload",
+    "type": "unknown",
+    "description": "The full MIME tree, raw -- mimeType, body (base64url in body.data for a leaf part), and nested parts for a multipart message. Decode it yourself for plain-text or HTML content; this connector does not flatten it."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var gmailInboxMessageGetKind = connectors.defineConnectorKind(GMAIL_INBOX_MESSAGE_GET_META, {
+  name: GMAIL_INBOX_MESSAGE_GET_KIND,
+  aliases: ["gmail_inbox_message_get"],
+  label: "Gmail message",
+  description: "Read one message's headers and preview. The body's plain/HTML text is NOT decoded -- see the raw payload for that.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GMAIL_INBOX_MESSAGE_GET_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "userId",
+      "label": "Mailbox",
+      "required": true,
+      "default": "me"
+    },
+    {
+      "type": "text",
+      "key": "id",
+      "label": "Message ID",
+      "required": true,
+      "description": "From message_list, or another node's output."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => connectors.summarize(GMAIL_INBOX_MESSAGE_GET_META, config, "read a message")
+});
+var GMAIL_INBOX_MESSAGE_LIST_KIND = "@particle-academy/gmail_inbox_message_list";
+var GMAIL_INBOX_MESSAGE_LIST_OPERATION = "message_list";
+var GMAIL_INBOX_MESSAGE_LIST_META = gmailInboxMeta("action", "list messages", "https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/list");
+var GMAIL_INBOX_MESSAGE_LIST_OUTPUT = [
+  {
+    "path": "data.messages",
+    "type": "array",
+    "description": "Each row is { id, threadId } only. Read a message's content with message_get."
+  },
+  {
+    "path": "data.nextPageToken",
+    "type": "string",
+    "description": "Present when there is another page."
+  },
+  {
+    "path": "data.resultSizeEstimate",
+    "type": "number",
+    "description": "Gmail's own word for it: an ESTIMATE, not an exact count."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var gmailInboxMessageListKind = connectors.defineConnectorKind(GMAIL_INBOX_MESSAGE_LIST_META, {
+  name: GMAIL_INBOX_MESSAGE_LIST_KIND,
+  aliases: ["gmail_inbox_message_list"],
+  label: "List Gmail messages",
+  description: "List message ids matching a search, newest first.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GMAIL_INBOX_MESSAGE_LIST_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "userId",
+      "label": "Mailbox",
+      "required": true,
+      "default": "me",
+      "description": "`me` is the connected account and is almost always what you want."
+    },
+    {
+      "type": "text",
+      "key": "q",
+      "label": "Search",
+      "description": `Gmail's own search syntax, exactly as typed into the Gmail search box -- e.g. "from:ada@example.test has:attachment newer_than:7d". Leave blank to list everything.`
+    },
+    {
+      "type": "text",
+      "key": "labelId",
+      "label": "Label ID",
+      "description": "Only messages with this label -- e.g. INBOX, or a label_list id. Gmail's own query parameter accepts several, repeated; this connector offers one for now -- combine more in the search field above instead, using Gmail's own label: search operator."
+    },
+    {
+      "type": "switch",
+      "key": "includeSpamTrash",
+      "label": "Include spam and trash",
+      "default": false
+    },
+    {
+      "type": "number",
+      "key": "maxResults",
+      "label": "Page size",
+      "min": 1,
+      "max": 500,
+      "default": 100,
+      "description": "Gmail's own maximum is 500."
+    },
+    {
+      "type": "text",
+      "key": "pageToken",
+      "label": "Page token",
+      "description": "From a previous page's nextPageToken."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => connectors.summarize(GMAIL_INBOX_MESSAGE_LIST_META, config, "list messages")
+});
+var GMAIL_INBOX_THREAD_GET_KIND = "@particle-academy/gmail_inbox_thread_get";
+var GMAIL_INBOX_THREAD_GET_OPERATION = "thread_get";
+var GMAIL_INBOX_THREAD_GET_META = gmailInboxMeta("action", "read a thread", "https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/get");
+var GMAIL_INBOX_THREAD_GET_OUTPUT = [
+  {
+    "path": "data.id",
+    "type": "string",
+    "description": "The thread id."
+  },
+  {
+    "path": "data.historyId",
+    "type": "string",
+    "description": "Gmail's change-tracking cursor as of this read."
+  },
+  {
+    "path": "data.messages",
+    "type": "array",
+    "description": "Every message in the thread, oldest first, each shaped like message_get's output."
+  },
+  {
+    "path": "mode",
+    "type": "string",
+    "description": "Which estate this ran against. Google has no sandbox, so: fake or live."
+  }
+];
+var gmailInboxThreadGetKind = connectors.defineConnectorKind(GMAIL_INBOX_THREAD_GET_META, {
+  name: GMAIL_INBOX_THREAD_GET_KIND,
+  aliases: ["gmail_inbox_thread_get"],
+  label: "Gmail thread",
+  description: "Read every message in a conversation thread, oldest first.",
+  inputs: [{ id: "in" }],
+  outputs: [{ id: "out" }],
+  sideEffects: "none",
+  outputShape: GMAIL_INBOX_THREAD_GET_OUTPUT,
+  configSchema: [
+    {
+      "type": "text",
+      "key": "userId",
+      "label": "Mailbox",
+      "required": true,
+      "default": "me"
+    },
+    {
+      "type": "text",
+      "key": "id",
+      "label": "Thread ID",
+      "required": true,
+      "description": "A message's threadId, from message_list or message_get."
+    }
+  ],
+  defaultConfig: {
+    "mode": "auto"
+  },
+  renderBody: ({ config }) => connectors.summarize(GMAIL_INBOX_THREAD_GET_META, config, "read a thread")
+});
+
+// src/index.ts
+var GMAIL_INBOX_KINDS = [
+  gmailInboxLabelListKind,
+  gmailInboxMessageGetKind,
+  gmailInboxMessageListKind,
+  gmailInboxThreadGetKind
+];
+
+exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
+exports.GMAIL_INBOX_CREDENTIALS = GMAIL_INBOX_CREDENTIALS;
+exports.GMAIL_INBOX_KINDS = GMAIL_INBOX_KINDS;
+exports.GMAIL_INBOX_LABEL_LIST_KIND = GMAIL_INBOX_LABEL_LIST_KIND;
+exports.GMAIL_INBOX_LABEL_LIST_META = GMAIL_INBOX_LABEL_LIST_META;
+exports.GMAIL_INBOX_LABEL_LIST_OPERATION = GMAIL_INBOX_LABEL_LIST_OPERATION;
+exports.GMAIL_INBOX_LABEL_LIST_OUTPUT = GMAIL_INBOX_LABEL_LIST_OUTPUT;
+exports.GMAIL_INBOX_MESSAGE_GET_KIND = GMAIL_INBOX_MESSAGE_GET_KIND;
+exports.GMAIL_INBOX_MESSAGE_GET_META = GMAIL_INBOX_MESSAGE_GET_META;
+exports.GMAIL_INBOX_MESSAGE_GET_OPERATION = GMAIL_INBOX_MESSAGE_GET_OPERATION;
+exports.GMAIL_INBOX_MESSAGE_GET_OUTPUT = GMAIL_INBOX_MESSAGE_GET_OUTPUT;
+exports.GMAIL_INBOX_MESSAGE_LIST_KIND = GMAIL_INBOX_MESSAGE_LIST_KIND;
+exports.GMAIL_INBOX_MESSAGE_LIST_META = GMAIL_INBOX_MESSAGE_LIST_META;
+exports.GMAIL_INBOX_MESSAGE_LIST_OPERATION = GMAIL_INBOX_MESSAGE_LIST_OPERATION;
+exports.GMAIL_INBOX_MESSAGE_LIST_OUTPUT = GMAIL_INBOX_MESSAGE_LIST_OUTPUT;
+exports.GMAIL_INBOX_OAUTH = GMAIL_INBOX_OAUTH;
+exports.GMAIL_INBOX_SERVICE = GMAIL_INBOX_SERVICE;
+exports.GMAIL_INBOX_THREAD_GET_KIND = GMAIL_INBOX_THREAD_GET_KIND;
+exports.GMAIL_INBOX_THREAD_GET_META = GMAIL_INBOX_THREAD_GET_META;
+exports.GMAIL_INBOX_THREAD_GET_OPERATION = GMAIL_INBOX_THREAD_GET_OPERATION;
+exports.GMAIL_INBOX_THREAD_GET_OUTPUT = GMAIL_INBOX_THREAD_GET_OUTPUT;
+exports.gmailInboxLabelListKind = gmailInboxLabelListKind;
+exports.gmailInboxMessageGetKind = gmailInboxMessageGetKind;
+exports.gmailInboxMessageListKind = gmailInboxMessageListKind;
+exports.gmailInboxMeta = gmailInboxMeta;
+exports.gmailInboxThreadGetKind = gmailInboxThreadGetKind;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/service.ts","../src/kinds/label-list.ts","../src/kinds/message-get.ts","../src/kinds/message-list.ts","../src/kinds/thread-get.ts","../src/index.ts"],"names":["defineConnectorKind","summarize"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * Gmail Inbox's identity on the authoring surface, shared by every Gmail Inbox\n * node.\n *\n * This file must import nothing from the js package: a PHP or Python project\n * installs the ui package and never that one, and the import would be a\n * dangling module the moment it did.\n *\n * ## The sandbox trap\n *\n * Gmail has no sandbox. Every read reaches the connected account's real mail.\n * The faker is the only way to develop against it without touching a real\n * mailbox.\n */\n\nimport type { ConnectorDomain, ConnectorMeta } from \"@particle-academy/fancy-flow/connectors\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported — an imported constant lets an upgrade rewrite the\n * very claim it exists to detect.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\n/** The parts of a connector's identity that belong to the SERVICE, not the node. */\nexport const GMAIL_INBOX_SERVICE = {\n  service: \"gmail_inbox\",\n  serviceTitle: \"Gmail Inbox\",\n  domain: \"email\",\n  sandbox: \"none\",\n} as const satisfies Pick<ConnectorMeta, \"service\" | \"serviceTitle\" | \"domain\" | \"sandbox\">;\n\n/**\n * Every connector domain weaver knows, pinned against fancy-flow's union.\n *\n * A closed set copied into three codebases stays correct only while something\n * MAKES it: this line fails to compile the moment weaver carries a value\n * fancy-flow does not, including the values no provider uses yet.\n */\nconst WEAVER_DOMAINS: readonly ConnectorDomain[] = [\n  \"payments\",\n  \"commerce\",\n  \"messaging\",\n  \"email\",\n  \"crm\",\n  \"support\",\n  \"storage\",\n  \"calendar\",\n  \"productivity\",\n  \"database\",\n  \"devtools\",\n  \"analytics\",\n  \"marketing\",\n  \"ai\",\n  \"forms\",\n  \"hr\",\n  \"geo\"\n];\nvoid WEAVER_DOMAINS;\n\n/** The credentials a Gmail Inbox connection holds. */\nexport const GMAIL_INBOX_CREDENTIALS = [\n  {\n    \"key\": \"clientId\",\n    \"label\": \"OAuth client ID\",\n    \"scope\": \"provider\",\n    \"secret\": false,\n    \"help\": \"A DIFFERENT OAuth app than `gmail`'s, from Google Cloud Console -> APIs & Services -> Credentials. This one requests a restricted scope and carries Google's annual CASA assessment; `gmail`'s does not. Do not reuse the same client for both.\"\n  },\n  {\n    \"key\": \"clientSecret\",\n    \"label\": \"OAuth client secret\",\n    \"scope\": \"provider\",\n    \"secret\": true,\n    \"help\": \"The client secret for the same OAuth app. One value for the whole installation.\"\n  },\n  {\n    \"key\": \"accessToken\",\n    \"label\": \"Access token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account, and it expires after ONE HOUR. The host refreshes it with the refresh token.\"\n  },\n  {\n    \"key\": \"refreshToken\",\n    \"label\": \"Refresh token\",\n    \"scope\": \"account\",\n    \"secret\": true,\n    \"help\": \"Per connected Google account. Google issues one only when the consent request asks for offline access; without it the connection dies within the hour.\"\n  }\n] as const;\n\n/**\n * The OAuth2 exchange Gmail Inbox requires — DECLARED here, performed by the\n * host.\n *\n * A consent screen needs a browser, a redirect URI and somewhere to persist\n * the result, and all three belong to the host; a package that ran the dance\n * itself would have to own a web server. So this says precisely enough for a\n * host to do it.\n *\n * The access token lasts 3600 seconds. A host that never refreshes will work\n * all afternoon and be broken by morning, which is why the lifetime is stated\n * rather than left to be discovered.\n *\n * Its refresh tokens do NOT rotate: the same one is reusable, so a refresh may\n * safely be retried and may run concurrently. That is stated rather than\n * assumed because the opposite — a provider that spends the token and revokes\n * the grant on a replay — looks identical until it happens.\n */\nexport const GMAIL_INBOX_OAUTH = {\n  \"flow\": \"authorization_code\",\n  \"authorizeUrl\": \"https://accounts.google.com/o/oauth2/v2/auth\",\n  \"tokenUrl\": \"https://oauth2.googleapis.com/token\",\n  \"scopes\": [\n    \"https://www.googleapis.com/auth/gmail.readonly\"\n  ],\n  \"accessTokenCredential\": \"accessToken\",\n  \"refreshTokenCredential\": \"refreshToken\",\n  \"refreshTokenRotates\": false,\n  \"accessTokenTtlSeconds\": 3600\n} as const;\n\n/** Build a Gmail Inbox node's connector metadata from the operation it performs. */\nexport function gmailInboxMeta(\n  role: ConnectorMeta[\"role\"],\n  operation: string,\n  docs: string,\n): ConnectorMeta {\n  return { ...GMAIL_INBOX_SERVICE, role, operation, docs };\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/label-list.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/label-list.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * List Gmail labels — List every label on the mailbox, system and\n * user-created.\n *\n * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.labels/list\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { gmailInboxMeta } from \"../service.js\";\n\nexport const GMAIL_INBOX_LABEL_LIST_KIND = \"@particle-academy/gmail_inbox_label_list\";\nexport const GMAIL_INBOX_LABEL_LIST_OPERATION = \"label_list\";\n\nexport const GMAIL_INBOX_LABEL_LIST_META = gmailInboxMeta(\"action\", \"list labels\", \"https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.labels/list\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GMAIL_INBOX_LABEL_LIST_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.labels\",\n    \"type\": \"array\",\n    \"description\": \"Each with id, name and type (system or user). messagesTotal/messagesUnread/threadsTotal/threadsUnread are part of Label's schema but not confirmed present on every list row -- read one label with labels.get if a count comes back missing.\"\n  }\n];\n\nexport const gmailInboxLabelListKind: NodeKindDefinition = defineConnectorKind(GMAIL_INBOX_LABEL_LIST_META, {\n  name: GMAIL_INBOX_LABEL_LIST_KIND,\n  aliases: [\"gmail_inbox_label_list\"],\n  label: \"List Gmail labels\",\n  description: \"List every label on the mailbox, system and user-created.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GMAIL_INBOX_LABEL_LIST_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"userId\",\n      \"label\": \"Mailbox\",\n      \"required\": true,\n      \"default\": \"me\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GMAIL_INBOX_LABEL_LIST_META, config as Record<string, unknown>, \"list labels\"),\n});\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/message-get.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/message-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * Gmail message — Read one message's headers and preview. The body's\n * plain/HTML text is NOT decoded -- see the raw payload for that.\n *\n * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/get\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { gmailInboxMeta } from \"../service.js\";\n\nexport const GMAIL_INBOX_MESSAGE_GET_KIND = \"@particle-academy/gmail_inbox_message_get\";\nexport const GMAIL_INBOX_MESSAGE_GET_OPERATION = \"message_get\";\n\nexport const GMAIL_INBOX_MESSAGE_GET_META = gmailInboxMeta(\"action\", \"read a message\", \"https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/get\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GMAIL_INBOX_MESSAGE_GET_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.id\",\n    \"type\": \"string\",\n    \"description\": \"The message id.\"\n  },\n  {\n    \"path\": \"data.threadId\",\n    \"type\": \"string\",\n    \"description\": \"The thread this message belongs to.\"\n  },\n  {\n    \"path\": \"data.labelIds\",\n    \"type\": \"array\",\n    \"description\": \"System and user label ids currently on this message.\"\n  },\n  {\n    \"path\": \"data.snippet\",\n    \"type\": \"string\",\n    \"description\": \"Gmail's own short plain-text preview of the body -- a few hundred characters, not the whole message.\"\n  },\n  {\n    \"path\": \"data.internalDate\",\n    \"type\": \"string\",\n    \"description\": \"Unix epoch MILLISECONDS, as a string -- when Gmail received it, which can differ from the Date header.\"\n  },\n  {\n    \"path\": \"data.payload.headers\",\n    \"type\": \"array\",\n    \"description\": \"Every RFC 2822 header as { name, value }, unparsed. From/To/Subject/Date live here.\"\n  },\n  {\n    \"path\": \"data.payload\",\n    \"type\": \"unknown\",\n    \"description\": \"The full MIME tree, raw -- mimeType, body (base64url in body.data for a leaf part), and nested parts for a multipart message. Decode it yourself for plain-text or HTML content; this connector does not flatten it.\"\n  },\n  {\n    \"path\": \"mode\",\n    \"type\": \"string\",\n    \"description\": \"Which estate this ran against. Google has no sandbox, so: fake or live.\"\n  }\n];\n\nexport const gmailInboxMessageGetKind: NodeKindDefinition = defineConnectorKind(GMAIL_INBOX_MESSAGE_GET_META, {\n  name: GMAIL_INBOX_MESSAGE_GET_KIND,\n  aliases: [\"gmail_inbox_message_get\"],\n  label: \"Gmail message\",\n  description: \"Read one message's headers and preview. The body's plain/HTML text is NOT decoded -- see the raw payload for that.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GMAIL_INBOX_MESSAGE_GET_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"userId\",\n      \"label\": \"Mailbox\",\n      \"required\": true,\n      \"default\": \"me\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"id\",\n      \"label\": \"Message ID\",\n      \"required\": true,\n      \"description\": \"From message_list, or another node's output.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GMAIL_INBOX_MESSAGE_GET_META, config as Record<string, unknown>, \"read a message\"),\n});\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/message-list.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/message-list.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * List Gmail messages — List message ids matching a search, newest first.\n *\n * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/list\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { gmailInboxMeta } from \"../service.js\";\n\nexport const GMAIL_INBOX_MESSAGE_LIST_KIND = \"@particle-academy/gmail_inbox_message_list\";\nexport const GMAIL_INBOX_MESSAGE_LIST_OPERATION = \"message_list\";\n\nexport const GMAIL_INBOX_MESSAGE_LIST_META = gmailInboxMeta(\"action\", \"list messages\", \"https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/list\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GMAIL_INBOX_MESSAGE_LIST_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.messages\",\n    \"type\": \"array\",\n    \"description\": \"Each row is { id, threadId } only. Read a message's content with message_get.\"\n  },\n  {\n    \"path\": \"data.nextPageToken\",\n    \"type\": \"string\",\n    \"description\": \"Present when there is another page.\"\n  },\n  {\n    \"path\": \"data.resultSizeEstimate\",\n    \"type\": \"number\",\n    \"description\": \"Gmail's own word for it: an ESTIMATE, not an exact count.\"\n  },\n  {\n    \"path\": \"mode\",\n    \"type\": \"string\",\n    \"description\": \"Which estate this ran against. Google has no sandbox, so: fake or live.\"\n  }\n];\n\nexport const gmailInboxMessageListKind: NodeKindDefinition = defineConnectorKind(GMAIL_INBOX_MESSAGE_LIST_META, {\n  name: GMAIL_INBOX_MESSAGE_LIST_KIND,\n  aliases: [\"gmail_inbox_message_list\"],\n  label: \"List Gmail messages\",\n  description: \"List message ids matching a search, newest first.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GMAIL_INBOX_MESSAGE_LIST_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"userId\",\n      \"label\": \"Mailbox\",\n      \"required\": true,\n      \"default\": \"me\",\n      \"description\": \"`me` is the connected account and is almost always what you want.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"q\",\n      \"label\": \"Search\",\n      \"description\": \"Gmail's own search syntax, exactly as typed into the Gmail search box -- e.g. \\\"from:ada@example.test has:attachment newer_than:7d\\\". Leave blank to list everything.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"labelId\",\n      \"label\": \"Label ID\",\n      \"description\": \"Only messages with this label -- e.g. INBOX, or a label_list id. Gmail's own query parameter accepts several, repeated; this connector offers one for now -- combine more in the search field above instead, using Gmail's own label: search operator.\"\n    },\n    {\n      \"type\": \"switch\",\n      \"key\": \"includeSpamTrash\",\n      \"label\": \"Include spam and trash\",\n      \"default\": false\n    },\n    {\n      \"type\": \"number\",\n      \"key\": \"maxResults\",\n      \"label\": \"Page size\",\n      \"min\": 1,\n      \"max\": 500,\n      \"default\": 100,\n      \"description\": \"Gmail's own maximum is 500.\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"pageToken\",\n      \"label\": \"Page token\",\n      \"description\": \"From a previous page's nextPageToken.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GMAIL_INBOX_MESSAGE_LIST_META, config as Record<string, unknown>, \"list messages\"),\n});\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/thread-get.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/thread-get.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * Gmail thread — Read every message in a conversation thread, oldest first.\n *\n * https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/get\n */\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { defineConnectorKind, summarize, type OutputField } from \"@particle-academy/fancy-flow/connectors\";\nimport { gmailInboxMeta } from \"../service.js\";\n\nexport const GMAIL_INBOX_THREAD_GET_KIND = \"@particle-academy/gmail_inbox_thread_get\";\nexport const GMAIL_INBOX_THREAD_GET_OPERATION = \"thread_get\";\n\nexport const GMAIL_INBOX_THREAD_GET_META = gmailInboxMeta(\"action\", \"read a thread\", \"https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.threads/get\");\n\n/**\n * What this node emits — the \"ingredients\" a downstream node can reference.\n *\n * fancy-flow reads `outputShape` off the kind and offers it in the variable\n * picker, so declaring it is the whole of the work: an author configuring the\n * next node picks `{{ $json.data.id }}` off a list instead of typing a path\n * and hoping.\n */\nexport const GMAIL_INBOX_THREAD_GET_OUTPUT: OutputField[] = [\n  {\n    \"path\": \"data.id\",\n    \"type\": \"string\",\n    \"description\": \"The thread id.\"\n  },\n  {\n    \"path\": \"data.historyId\",\n    \"type\": \"string\",\n    \"description\": \"Gmail's change-tracking cursor as of this read.\"\n  },\n  {\n    \"path\": \"data.messages\",\n    \"type\": \"array\",\n    \"description\": \"Every message in the thread, oldest first, each shaped like message_get's output.\"\n  },\n  {\n    \"path\": \"mode\",\n    \"type\": \"string\",\n    \"description\": \"Which estate this ran against. Google has no sandbox, so: fake or live.\"\n  }\n];\n\nexport const gmailInboxThreadGetKind: NodeKindDefinition = defineConnectorKind(GMAIL_INBOX_THREAD_GET_META, {\n  name: GMAIL_INBOX_THREAD_GET_KIND,\n  aliases: [\"gmail_inbox_thread_get\"],\n  label: \"Gmail thread\",\n  description: \"Read every message in a conversation thread, oldest first.\",\n  inputs: [{ id: \"in\" }],\n  outputs: [{ id: \"out\" }],\n  sideEffects: \"none\",\n  outputShape: GMAIL_INBOX_THREAD_GET_OUTPUT,\n  configSchema: [\n    {\n      \"type\": \"text\",\n      \"key\": \"userId\",\n      \"label\": \"Mailbox\",\n      \"required\": true,\n      \"default\": \"me\"\n    },\n    {\n      \"type\": \"text\",\n      \"key\": \"id\",\n      \"label\": \"Thread ID\",\n      \"required\": true,\n      \"description\": \"A message's threadId, from message_list or message_get.\"\n    }\n  ],\n  defaultConfig: {\n    \"mode\": \"auto\"\n  },\n  renderBody: ({ config }) =>\n    summarize(GMAIL_INBOX_THREAD_GET_META, config as Record<string, unknown>, \"read a thread\"),\n});\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- gmail_inbox\n */\n\n/**\n * Gmail Inbox's node kinds for fancy-flow.\n *\n * Install this on every host. The TypeScript executors live in the js\n * package's `./flow` subpath; PHP and Python hosts run their own and need only\n * this.\n */\n\nexport * from \"./service.js\";\nexport * from \"./kinds/label-list.js\";\nexport * from \"./kinds/message-get.js\";\nexport * from \"./kinds/message-list.js\";\nexport * from \"./kinds/thread-get.js\";\n\nimport type { NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport { gmailInboxLabelListKind } from \"./kinds/label-list.js\";\nimport { gmailInboxMessageGetKind } from \"./kinds/message-get.js\";\nimport { gmailInboxMessageListKind } from \"./kinds/message-list.js\";\nimport { gmailInboxThreadGetKind } from \"./kinds/thread-get.js\";\n\n/** Every Gmail Inbox kind, for a host that registers the lot. */\nexport const GMAIL_INBOX_KINDS: NodeKindDefinition[] = [\n  gmailInboxLabelListKind,\n  gmailInboxMessageGetKind,\n  gmailInboxMessageListKind,\n  gmailInboxThreadGetKind,\n];\n"]}