flowstate-connector-google-mail Package Skill

Package: @epicdm/flowstate-connector-google-mail Repository: epic-flowstate-community Path: packages/flowstate-connector-google-mail Version: 1.0.0

Use this published Dojo skill as the package-level entrypoint. For detailed workflows, use the package-local skills listed below.

Primary Package Workflow

FlowState Connector Google Mail Endpoints

Status: Active Purpose: Teach agents the Gmail endpoint contracts. Scope: connector.yaml endpoints. Trigger: Endpoint path, params, pagination, scopes, or send passthrough changes. Input: Gmail API operation details. Output: Correct endpoint manifest edits.

Endpoints

ID	Method	Path	Result
`labels`	`GET`	`/gmail/v1/users/me/labels`	`$.labels[*]`
`inbox-messages`	`GET`	`/gmail/v1/users/me/messages`	`$.messages[*]`
`sent-messages`	`GET`	`/gmail/v1/users/me/messages`	`$.messages[*]`
`send-message`	`POST`	`/gmail/v1/users/me/messages/send`	send result

Message endpoints use cursor pagination:

nextCursorPath: $.nextPageToken
cursorParam: pageToken
pageSizeParam: maxResults
pageSize: 50

inbox-messages defaults labelIds: INBOX; sent-messages defaults labelIds: SENT.

send-message requires body param raw: base64url-encoded RFC 2822 message. It has sync.enabled: false.

Full message detail retrieval is not represented by a manifest endpoint here. It lives in the provider-neutral FlowState mail tools and Google Mail runtime client under packages/flowstate-connector.

Red Flags

Red Flag	Corrective Action
Expecting full message body from list endpoints	Use FlowState mail tools for full message retrieval.
Treating send-message as scheduled sync	It is passthrough with sync disabled.
Removing `nextPageToken` cursor pagination	Gmail message listing is cursor-paginated.
Reading `directions: [pull]` as "no send support"	Send is not a sync direction; it is handled by mail tools/API passthrough.

Created: 2026-06-29

Package Skill Inventory

@epicdm/flowstate-connector-google-mail Skill Inventory

Skill	Type	Use When
`flowstate-connector-google-mail`	Orchestrator	Routing Google Mail connector tasks.
`flowstate-connector-google-mail-manifest`	Workflow/reference	OAuth, env vars, scopes, plugin metadata.
`flowstate-connector-google-mail-endpoints`	Reference	Labels, inbox/sent message indexes, send-message passthrough.
`flowstate-connector-google-mail-mapping`	Reference	Mapping labels/message indexes/send results into documents.
`flowstate-connector-google-mail-maintenance`	Maintenance	Tests, bundled copy, build/publish, Dojo drift, mail CLI coupling.

Do not create one skill per YAML file. Teach the operational connector workflows.

Review Gate

@epicdm/flowstate-connector-google-mail Skill Review

Created manifest-oriented package-local skills for Google Mail under packages/flowstate-connector-google-mail/.flowstate/skills.

Evidence Reviewed

package.json
README.md
connector.yaml
flowstate.plugin.json
__tests__/connector.test.ts
.flowstate/feature-matrix/inventory.md
.flowstate/dojo/agent-skillset.md
packages/connector-core/manifests/google-mail.yaml
packages/connector-core/src/manifest/__tests__/bundled-manifests.test.ts
packages/flowstate-cli/src/templates/compose/services.ts
packages/flowstate-cli/src/cli-commands/mail/*
packages/flowstate-connector/src/lib/google-mail-client.ts
packages/flowstate-connector/src/mcp/tools/connector-mail-pull.ts
packages/flowstate-connector/src/mcp/tools/connector-mail-send.ts
packages/flowstate-connector/src/mcp/tools/connector-mail-mailboxes.ts
packages/flowstate-connector/src/mcp/tools/connector-mail-test.ts

Known Drift Preserved

No JS/TS public exports exist.
Message-list endpoints return indexes, not full bodies.
send-message is sync-disabled passthrough requiring raw base64url RFC 2822.
FlowState mail CLI owns full mail workflows around connector capabilities.
Provider-id usage matters more than package-name imports; search for google-mail.
Generated Dojo material is generic and not publish-ready.

Verification Status

Completed after authoring:

ASCII scan: passed.
Frontmatter scan: passed.
Bundled manifest diff against packages/connector-core/manifests/google-mail.yaml: passed, no differences.
yarn workspace @epicdm/flowstate-connector-google-mail test --runInBand: passed, 1 suite and 4 tests.
yarn workspace @epicdm/flowstate-connector-google-mail build: passed; printed no-build message by design.
yarn nx build @epicdm/flowstate-connector-google-mail: passed with cached dependency outputs and connector no-build target; Nx Cloud reported existing unconnected-workspace 401.

flowstate-epic-flowstate-community-epicdm-flowstate-connector-google-mail

Tags

Publisher

Versions

Skill