@pome-sh/cli 0.7.0 → 0.8.0

package/node_modules/@pome-sh/twin-gmail/README.md

@@ -6,7 +6,7 @@ Deterministic Gmail-shaped twin for agent testing (Pome).
 SQLite mailbox model, strict seed/reset APIs, canonical MIME storage, identity,
 delivery, drafts, labels/history/search, bounded semantic state export,
 recording projection, the frozen Gmail REST/upload surface, and the captured
-ten-tool first-party MCP contract.
+thirteen-tool first-party MCP contract (Gate 1).
 
 ## Auth identity (frozen)
 
@@ -29,22 +29,24 @@ revealing mailbox existence.
 | Path | Role |
 | --- | --- |
 | [`fixtures/rest-surface.json`](fixtures/rest-surface.json) | Frozen launch REST method/parameter/media matrix from Gmail v1 discovery |
-| [`fixtures/mcp-tools-list.*.json`](fixtures/) | Official Gmail MCP `tools/list` raw + canonical (10-tool launch set) |
+| [`fixtures/mcp-tools-list.*.json`](fixtures/) | Official Gmail MCP `tools/list` raw + canonical (13-tool Gate-1 launch set) |
 | [`fidelity.inventory.json`](fidelity.inventory.json) | Heat × fidelity × evidence for every launch REST/MCP row |
+| [`FIDELITY.md`](FIDELITY.md) | Human-readable heat × fidelity tables (linted against inventory) |
 | [`REFERENCE-DIVERGENCES.md`](REFERENCE-DIVERGENCES.md) | Emulate rejected; never an oracle |
 | [`LIMITS.md`](LIMITS.md) | Limit placeholders (discovery maxima + TBD local caps) |
 
 See [`fixtures/README.md`](fixtures/README.md) for capture provenance and SHA-256.
 
-## Launch MCP tools (exactly 10)
+## Launch MCP tools (exactly 13)
 
-`create_draft`, `list_drafts`, `get_thread`, `search_threads`, `label_thread`,
-`unlabel_thread`, `list_labels`, `label_message`, `unlabel_message`,
+`create_draft`, `list_drafts`, `get_thread`, `get_message`, `search_threads`,
+`label_thread`, `unlabel_thread`, `apply_sensitive_thread_label`, `list_labels`,
+`label_message`, `unlabel_message`, `apply_sensitive_message_label`,
 `create_label`.
 
-Order and schemas are frozen from the live listing capture (relative order among
-the launch set). Three extra preview tools seen live are **out of launch scope**
-(named cold in the inventory).
+Order and schemas are frozen from the live Developer Preview listing capture.
+Gate 1 promotes `get_message` and the two `apply_sensitive_*` tools that were
+previously named cold preview drift under the Gate 0 ten-tool freeze.
 
 ## Named 501 gaps (not fake success)
 
@@ -61,7 +63,7 @@ the launch set). Three extra preview tools seen live are **out of launch scope**
 - Calendar, Drive, Contacts, client UI, CSE, delegates, S/MIME, admin controls
 - HTTP batch API
 - Resumable upload
-- Expanding MCP beyond the frozen 10-tool launch set without a new Gate 0 ruling
+- Expanding MCP beyond the frozen Gate-1 13-tool launch set without a new ruling
 
 ## Limits
 
@@ -84,6 +86,45 @@ Gmail follows the same SDK chassis as GitHub / Slack / Stripe:
 
 Intentional differences: no Google OAuth (Pome JWT only); watch/stop 501; Stripe-style idempotency/failure-injection middleware is Stripe-only.
 
+## Runtime contract (for snapshot consumers)
+
+`pome-cloud` builds a Vercel Sandbox snapshot from this package's signed source
+artifact. The following constraints must hold for that build to succeed and for
+the resulting snapshot to boot. Changing any of these is a breaking change for
+hosted; land the producer change here first, then open the cloud consumer PR
+that pins and verifies the new signed digest.
+
+### Build
+
+- Package is `npm install`-able from `package.json` alone (no `workspace:*`
+  protocols, no package-manager-specific deps; no committed lockfile is required, the snapshot
+  build regenerates one on each rebuild)
+- `npm run build` exits 0 and emits `dist/src/server.js`
+- Built output is loadable under Node 24 — the snapshot runs `runtime: "node24"`.
+  SQLite is the built-in `node:sqlite` (via the sdk's `openTwinDatabase()`) —
+  no native modules, no compiler toolchain.
+
+### Runtime
+
+- Server entry: `node dist/src/server.js` (cwd = package root)
+- Listens on `:3336` by default (`GMAIL_TWIN_PORT`, then the native default)
+- **Hosted normalizes the port to `PORT=3333`.** The server honors the `PORT`
+  env var first (`PORT` → `GMAIL_TWIN_PORT` → `3336`); the pome-cloud
+  control-plane sets `PORT=3333` at spawn for every twin, so the native `3336`
+  default is only used for standalone local runs.
+- Honors `GMAIL_TWIN_HOST=0.0.0.0` env (default `127.0.0.1` is unreachable via
+  Vercel Sandbox port forwarding)
+- `GET /healthz` returns 200 within ~3s of process start (the snapshot build
+  sleeps 3s after `node dist/src/server.js` before probing)
+- Seed via `POME_SEED_JSON` (strict Gmail seed schema)
+- Bearer auth at `Authorization: Bearer <jwt>` — Pome session JWT, not a Google
+  OAuth access token
+
+### Cloud consumer coordination
+
+- Bumping any of the above = publish a signed twin digest and open the matching
+  `pome-cloud` consumer PR.
+
 ## Development
 
 ```bash
@@ -104,6 +145,6 @@ npx @pome-sh/cli twin start gmail
 # and the identical POME_GMAIL_TOKEN alias
 ```
 
-Use `pome scenarios gmail --copy` for the inbox-triage and captured first-party
-MCP parity scenarios. Hosted rollout is gated separately; see
+Use `pome tasks gmail --copy` for the inbox-triage and captured first-party
+MCP parity tasks. Hosted rollout is gated separately; see
 [`HOSTED.md`](HOSTED.md).

package/node_modules/@pome-sh/twin-gmail/dist/fixtures/mcp-tools-list.canonical.json

@@ -1,13 +1,13 @@
 {
     "meta": {
-        "source": "live_unauthenticated_tools_list_filtered_to_launch_set",
+        "source": "live_unauthenticated_tools_list_gate1_launch_set",
         "endpoint": "https://gmailmcp.googleapis.com/mcp/v1",
         "method": "tools/list",
         "protocol": "JSON-RPC 2.0 over HTTP (accept: application/json, text/event-stream)",
         "protocolVersion": "2025-03-26",
         "captureDate": "2026-07-20",
         "rawFileSha256": "6ef35bad568967015c101f89e995148c4eb2131b3a6dd244f7237058abae8e7a",
-        "launchToolCount": 10,
+        "launchToolCount": 13,
         "liveToolCount": 13,
         "liveToolOrder": [
             "create_draft",
@@ -28,28 +28,43 @@
             "create_draft",
             "list_drafts",
             "get_thread",
+            "get_message",
             "search_threads",
             "label_thread",
             "unlabel_thread",
+            "apply_sensitive_thread_label",
             "list_labels",
             "label_message",
             "unlabel_message",
+            "apply_sensitive_message_label",
             "create_label"
         ],
-        "excludedFromLaunch": [
+        "gate0LaunchToolOrder": [
+            "create_draft",
+            "list_drafts",
+            "get_thread",
+            "search_threads",
+            "label_thread",
+            "unlabel_thread",
+            "list_labels",
+            "label_message",
+            "unlabel_message",
+            "create_label"
+        ],
+        "gate1PromotedFromPreview": [
             "get_message",
             "apply_sensitive_thread_label",
             "apply_sensitive_message_label"
         ],
         "notes": [
             "Raw live tools/list returned 13 tools without auth (Developer Preview).",
-            "Gate 0 launch set is exactly the 10 tools named in the Gmail twin plan / public tool reference.",
-            "Schemas/annotations/descriptions for launch tools are copied verbatim from the live capture.",
-            "Excluded live tools (get_message, apply_sensitive_thread_label, apply_sensitive_message_label) are preview drift vs the documented 10-tool launch set — not served by the twin while claiming official listing parity.",
+            "Gate 1 expands the OSS launch set from the Gate 0 ten-tool freeze to the full live 13-tool listing.",
+            "Schemas/annotations/descriptions for all launch tools are copied verbatim from the live capture.",
+            "Promoted Gate-1 tools: get_message, apply_sensitive_thread_label, apply_sensitive_message_label.",
             "Authenticated tools/call success envelopes were unavailable; see mcp-tools-call.representative.json and mcp-tools-call-unauth-error.raw.json.",
             "initialize returned protocolVersion=2025-03-26 (see mcp-initialize.raw.json)."
         ],
-        "canonicalSha256": "8771e967b1c8d5c364de2a05c890aaddd27fb9eba45fde68e18d767b1dfc7ac3"
+        "canonicalSha256": "56b5e86181c13ead63fdc8ea0d4bedc6860c1a3fdb17372fdca76591e48a4eed"
     },
     "jsonrpc": "2.0",
     "id": 1,
@@ -463,6 +478,138 @@
                     "type": "object"
                 }
             },
+            {
+                "annotations": {
+                    "destructiveHint": false,
+                    "idempotentHint": true,
+                    "openWorldHint": false,
+                    "readOnlyHint": true,
+                    "title": "Retrieves a specific email message from the authenticated user's Gmail account."
+                },
+                "description": "Retrieves a specific email message from the authenticated user's Gmail account by its unique message ID.\n\nUse this tool to inspect a single, individual email when you already know its message ID. If the user wants to read a specific email in detail, check the exact wording of a message, or examine attachment metadata for a single email, this is the right tool. It is not suitable for retrieving entire conversations or viewing back-and-forth discussion threads; use the 'get_thread' tool instead.\nKey indicators include if the user asks for the full content of a specific message ID returned by a previous search, or if the query asks to inspect a specific individual email rather than an entire thread.\nExample user prompts are: \"Get the full text of message ID 18f123456789abcd.\", \"Read the latest message in that thread from Alice.\", and \"What are the attachment names in the email I just received from HR?\" \n\nThe optional `messageFormat` parameter controls the format of the message returned. By default (or with `FULL_CONTENT`), it returns the full content of the message. Use `MINIMAL` to include only subject and snippet (excluding body). Use `METADATA_ONLY` to include only basic metadata (message ID, thread ID, labels, timestamp, and size estimate). \n",
+                "inputSchema": {
+                    "description": "Request message for GetMessage RPC.",
+                    "properties": {
+                        "messageFormat": {
+                            "description": "Optional. Specifies the format of the message returned. Defaults to FULL_CONTENT.",
+                            "enum": [
+                                "MESSAGE_FORMAT_UNSPECIFIED",
+                                "MINIMAL",
+                                "FULL_CONTENT",
+                                "METADATA_ONLY"
+                            ],
+                            "type": "string",
+                            "x-google-enum-descriptions": [
+                                "Defaults to FULL_CONTENT.",
+                                "Returns message snippets and key headers (Subject, From, To, Cc, Date).",
+                                "Returns all information in \"MINIMAL\" plus the full body content of each message.",
+                                "Metadata only: does not include subject, snippet, body, attachment filenames."
+                            ]
+                        },
+                        "messageId": {
+                            "description": "Required. The unique identifier of the message to fetch.",
+                            "type": "string"
+                        }
+                    },
+                    "required": [
+                        "messageId"
+                    ],
+                    "type": "object"
+                },
+                "name": "get_message",
+                "outputSchema": {
+                    "$defs": {
+                        "AttachmentMetadata": {
+                            "description": "Represents an attachment associated with a message.",
+                            "properties": {
+                                "filename": {
+                                    "description": "The filename of the attachment.",
+                                    "type": "string"
+                                },
+                                "id": {
+                                    "description": "Output only. The ID of the attachment.",
+                                    "readOnly": true,
+                                    "type": "string"
+                                },
+                                "mimeType": {
+                                    "description": "The MIME type of the attachment.",
+                                    "type": "string"
+                                }
+                            },
+                            "type": "object"
+                        }
+                    },
+                    "description": "Message within a thread.",
+                    "properties": {
+                        "attachmentIds": {
+                            "description": "Output only. The attachment ids, only populated if MessageFormat was FULL_CONTENT.",
+                            "items": {
+                                "type": "string"
+                            },
+                            "readOnly": true,
+                            "type": "array"
+                        },
+                        "attachments": {
+                            "description": "Output only. The attachments, only populated if MessageFormat was FULL_CONTENT.",
+                            "items": {
+                                "$ref": "#/$defs/AttachmentMetadata"
+                            },
+                            "readOnly": true,
+                            "type": "array"
+                        },
+                        "ccRecipients": {
+                            "description": "CC recipient email addresses.",
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array"
+                        },
+                        "date": {
+                            "description": "Date of the message in ISO 8601 format (YYYY-MM-DD).",
+                            "type": "string"
+                        },
+                        "htmlBody": {
+                            "description": "The HTML content of the email, only populated if MessageFormat was FULL_CONTENT.",
+                            "type": "string"
+                        },
+                        "id": {
+                            "description": "The unique identifier of the message.",
+                            "type": "string"
+                        },
+                        "labelIds": {
+                            "description": "The ids of the labels attached to the message. Includes ids of user labels and standard system labels limited to \"INBOX\", \"SPAM\", \"TRASH\", \"UNREAD\", \"STARRED\", \"IMPORTANT\", \"SENT\", \"DRAFT\", \"CHAT\".",
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array"
+                        },
+                        "plaintextBody": {
+                            "description": "Full body content, only populated if MessageFormat was FULL_CONTENT.",
+                            "type": "string"
+                        },
+                        "sender": {
+                            "description": "Sender email address.",
+                            "type": "string"
+                        },
+                        "snippet": {
+                            "description": "Snippet of the message body.",
+                            "type": "string"
+                        },
+                        "subject": {
+                            "description": "The message subject extracted from headers:",
+                            "type": "string"
+                        },
+                        "toRecipients": {
+                            "description": "To recipient email addresses.",
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array"
+                        }
+                    },
+                    "type": "object"
+                }
+            },
             {
                 "annotations": {
                     "destructiveHint": false,
@@ -716,6 +863,50 @@
                     "type": "object"
                 }
             },
+            {
+                "annotations": {
+                    "destructiveHint": true,
+                    "idempotentHint": true,
+                    "openWorldHint": false,
+                    "readOnlyHint": false,
+                    "title": "Adds a sensitive label (Trash or Spam) to a thread."
+                },
+                "description": "Adds a sensitive label (Trash or Spam) to an entire thread in the authenticated user's Gmail account. This operation affects all messages currently in the thread and any future messages added to it.\n\nUse this tool to trash or mark a thread as spam. If unsure of the thread ID, use the `search_threads` tool first.\n",
+                "inputSchema": {
+                    "description": "Request message for ApplySensitiveThreadLabel RPC.",
+                    "properties": {
+                        "labelOption": {
+                            "description": "Required. The sensitive label option to add.",
+                            "enum": [
+                                "LABEL_OPTION_UNSPECIFIED",
+                                "TRASH",
+                                "SPAM"
+                            ],
+                            "type": "string",
+                            "x-google-enum-descriptions": [
+                                "Unspecified label option.",
+                                "Trash label.",
+                                "Spam label."
+                            ]
+                        },
+                        "threadId": {
+                            "description": "Required. The ID of the thread to add the label to.",
+                            "type": "string"
+                        }
+                    },
+                    "required": [
+                        "threadId",
+                        "labelOption"
+                    ],
+                    "type": "object"
+                },
+                "name": "apply_sensitive_thread_label",
+                "outputSchema": {
+                    "description": "Response message for ApplySensitiveThreadLabel RPC.",
+                    "properties": {},
+                    "type": "object"
+                }
+            },
             {
                 "annotations": {
                     "destructiveHint": false,
@@ -877,6 +1068,50 @@
                     "type": "object"
                 }
             },
+            {
+                "annotations": {
+                    "destructiveHint": true,
+                    "idempotentHint": true,
+                    "openWorldHint": false,
+                    "readOnlyHint": false,
+                    "title": "Adds a sensitive label (Trash or Spam) to a message."
+                },
+                "description": "Adds a sensitive label (Trash or Spam) to a specific message in the authenticated user's Gmail account.\n\nUse this tool to trash or mark a message as spam. To find the message ID, use tools like `search_threads` or `get_thread`.\n",
+                "inputSchema": {
+                    "description": "Request message for ApplySensitiveMessageLabel RPC.",
+                    "properties": {
+                        "labelOption": {
+                            "description": "Required. The sensitive label option to add.",
+                            "enum": [
+                                "LABEL_OPTION_UNSPECIFIED",
+                                "TRASH",
+                                "SPAM"
+                            ],
+                            "type": "string",
+                            "x-google-enum-descriptions": [
+                                "Unspecified label option.",
+                                "Trash label.",
+                                "Spam label."
+                            ]
+                        },
+                        "messageId": {
+                            "description": "Required. The ID of the message to add the label to.",
+                            "type": "string"
+                        }
+                    },
+                    "required": [
+                        "messageId",
+                        "labelOption"
+                    ],
+                    "type": "object"
+                },
+                "name": "apply_sensitive_message_label",
+                "outputSchema": {
+                    "description": "Response message for ApplySensitiveMessageLabel RPC.",
+                    "properties": {},
+                    "type": "object"
+                }
+            },
             {
                 "annotations": {
                     "destructiveHint": false,

package/node_modules/@pome-sh/twin-gmail/dist/src/db.js

@@ -6,6 +6,11 @@ CREATE TABLE IF NOT EXISTS gmail_config (
   value TEXT NOT NULL
 );
 
+CREATE TABLE IF NOT EXISTS fault_counters (
+  operation TEXT PRIMARY KEY,
+  calls INTEGER NOT NULL DEFAULT 0
+);
+
 CREATE TABLE IF NOT EXISTS mailboxes (
   id INTEGER PRIMARY KEY AUTOINCREMENT,
   email TEXT NOT NULL COLLATE NOCASE UNIQUE,
@@ -180,6 +185,7 @@ CREATE INDEX IF NOT EXISTS idx_filters_mailbox
 `;
 const RESET_SQL = `
 DELETE FROM gmail_config;
+DELETE FROM fault_counters;
 DELETE FROM send_as;
 DELETE FROM forwarding_addresses;
 DELETE FROM filters;

package/node_modules/@pome-sh/twin-gmail/dist/src/db.js.map

@@ -1 +1 @@
-{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiLrB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;CAejB,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,UAAU;IAClF,OAAO,gBAAgB,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EAAqB;IAC3C,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAqB;IACjD,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACrB,CAAC"}
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsLrB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;CAgBjB,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,UAAU;IAClF,OAAO,gBAAgB,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EAAqB;IAC3C,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAqB;IACjD,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACrB,CAAC"}

package/node_modules/@pome-sh/twin-gmail/dist/src/domain/drafts.d.ts

@@ -0,0 +1,41 @@
+import type { SeedAttachment, SemanticMessage } from "../types.js";
+import type { GmailDomain } from "./gmail-domain.js";
+import { sendMessage } from "./messages.js";
+export type DraftResource = {
+    id: string;
+    message: SemanticMessage;
+    updatedAt: string;
+};
+export declare function createDraft(domain: GmailDomain, email: string, raw: Uint8Array | string, options?: {
+    threadId?: string;
+}): {
+    id: string;
+    message: SemanticMessage;
+};
+export declare function createComposedDraft(domain: GmailDomain, email: string, input: {
+    to?: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject?: string;
+    text?: string;
+    html?: string;
+    replyToMessageId?: string;
+    attachments?: SeedAttachment[];
+}): {
+    id: string;
+    message: SemanticMessage;
+};
+export declare function listDrafts(domain: GmailDomain, email: string, query?: string): Array<{
+    id: string;
+    message: SemanticMessage;
+}>;
+export declare function drafts(domain: GmailDomain, email: string, query?: string, includeTrash?: boolean): DraftResource[];
+export declare function draft(domain: GmailDomain, email: string, draftId: string): DraftResource;
+export declare function updateDraft(domain: GmailDomain, email: string, draftId: string, raw: Uint8Array | string, options?: {
+    threadId?: string;
+}): {
+    id: string;
+    message: SemanticMessage;
+};
+export declare function sendDraft(domain: GmailDomain, email: string, draftId: string): ReturnType<typeof sendMessage>;
+export declare function deleteDraft(domain: GmailDomain, email: string, draftId: string): void;

package/node_modules/@pome-sh/twin-gmail/dist/src/domain/drafts.js

@@ -0,0 +1,138 @@
+// SPDX-License-Identifier: Apache-2.0
+import { notFound } from "../errors.js";
+import { composeMime } from "../mime.js";
+import { addHistory, insertStoredMessage, nextId, nextTimestamp, rawMessage, semanticMessage } from "../storage.js";
+import { acceptedRaw, removeEmptyThread, searchMessages, sendMessage } from "./messages.js";
+export function createDraft(domain, email, raw, options = {}) {
+    const mailboxId = domain.mailboxId(email);
+    const bytes = acceptedRaw(raw);
+    return domain.db.transaction(() => {
+        const message = insertStoredMessage(domain.db, mailboxId, bytes, {
+            threadId: options.threadId,
+            draft: true,
+        });
+        const draftId = nextId(domain.db, mailboxId, "draft_counter", "draft");
+        const now = nextTimestamp(domain.db, mailboxId);
+        domain.db
+            .prepare("INSERT INTO drafts(mailbox_id, id, message_id, created_at, updated_at) VALUES (?, ?, ?, ?, ?)")
+            .run(mailboxId, draftId, message.id, now, now);
+        addHistory(domain.db, mailboxId, message.id, message.threadId, "draftCreated", ["DRAFT"]);
+        return { id: draftId, message };
+    }).immediate();
+}
+export function createComposedDraft(domain, email, input) {
+    const mailboxId = domain.mailboxId(email);
+    return domain.db.transaction(() => {
+        const reply = input.replyToMessageId
+            ? semanticMessage(domain.db, mailboxId, input.replyToMessageId)
+            : undefined;
+        const raw = composeMime({
+            from: email,
+            to: input.to,
+            cc: input.cc,
+            bcc: input.bcc,
+            subject: input.subject ?? (reply ? `Re: ${reply.subject}` : ""),
+            text: reply ? [input.text ?? "", reply.text].filter(Boolean).join("\r\n\r\n") : input.text,
+            html: reply ? [input.html ?? "", reply.html].filter(Boolean).join("<br><br>") : input.html,
+            date: nextTimestamp(domain.db, mailboxId),
+            messageId: `${nextId(domain.db, mailboxId, "message_counter", "rfc")}@pome-twin.test`,
+            inReplyTo: reply?.rfcMessageId,
+            references: reply ? [reply.rfcMessageId] : undefined,
+            attachments: input.attachments,
+        });
+        return createDraft(domain, email, raw, { threadId: reply?.threadId });
+    }).immediate();
+}
+export function listDrafts(domain, email, query = "") {
+    const mailboxId = domain.mailboxId(email);
+    const rows = domain.db
+        .prepare(`SELECT d.id, d.message_id
+       FROM drafts d JOIN messages m ON m.mailbox_id = d.mailbox_id AND m.id = d.message_id
+       WHERE d.mailbox_id = ? ORDER BY d.updated_at DESC, d.id DESC`)
+        .all(mailboxId);
+    const matchingIds = query
+        ? new Set(searchMessages(domain, email, `in:draft ${query}`, { includeTrash: true }).map((message) => message.id))
+        : undefined;
+    return rows
+        .filter((row) => matchingIds?.has(row.message_id) ?? true)
+        .map((row) => ({ id: row.id, message: semanticMessage(domain.db, mailboxId, row.message_id) }));
+}
+export function drafts(domain, email, query = "", includeTrash = false) {
+    const mailboxId = domain.mailboxId(email);
+    const matching = query
+        ? new Set(searchMessages(domain, email, query, { includeTrash }).map((message) => message.id))
+        : null;
+    const rows = domain.db
+        .prepare("SELECT id, message_id, updated_at FROM drafts WHERE mailbox_id = ? ORDER BY updated_at DESC, id DESC")
+        .all(mailboxId);
+    return rows
+        .filter((row) => !matching || matching.has(row.message_id))
+        .map((row) => ({
+        id: row.id,
+        message: semanticMessage(domain.db, mailboxId, row.message_id),
+        updatedAt: row.updated_at,
+    }));
+}
+export function draft(domain, email, draftId) {
+    const mailboxId = domain.mailboxId(email);
+    const row = domain.db
+        .prepare("SELECT id, message_id, updated_at FROM drafts WHERE mailbox_id = ? AND id = ?")
+        .get(mailboxId, draftId);
+    if (!row)
+        notFound("Draft");
+    return { id: row.id, message: semanticMessage(domain.db, mailboxId, row.message_id), updatedAt: row.updated_at };
+}
+export function updateDraft(domain, email, draftId, raw, options = {}) {
+    const mailboxId = domain.mailboxId(email);
+    const bytes = acceptedRaw(raw);
+    return domain.db.transaction(() => {
+        const draftRow = requireDraft(domain, mailboxId, draftId);
+        const old = semanticMessage(domain.db, mailboxId, draftRow.message_id);
+        const replacement = insertStoredMessage(domain.db, mailboxId, bytes, {
+            threadId: options.threadId,
+            draft: true,
+        });
+        const now = nextTimestamp(domain.db, mailboxId);
+        domain.db
+            .prepare("UPDATE drafts SET message_id = ?, updated_at = ? WHERE mailbox_id = ? AND id = ?")
+            .run(replacement.id, now, mailboxId, draftId);
+        domain.db.prepare("DELETE FROM messages WHERE mailbox_id = ? AND id = ?").run(mailboxId, draftRow.message_id);
+        removeEmptyThread(domain, mailboxId, old.threadId);
+        addHistory(domain.db, mailboxId, draftRow.message_id, old.threadId, "draftReplaced");
+        return { id: draftId, message: replacement };
+    }).immediate();
+}
+export function sendDraft(domain, email, draftId) {
+    const mailboxId = domain.mailboxId(email);
+    return domain.db.transaction(() => {
+        const draftRow = requireDraft(domain, mailboxId, draftId);
+        const raw = rawMessage(domain.db, mailboxId, draftRow.message_id);
+        const old = semanticMessage(domain.db, mailboxId, draftRow.message_id);
+        domain.db.prepare("DELETE FROM drafts WHERE mailbox_id = ? AND id = ?").run(mailboxId, draftId);
+        domain.db.prepare("DELETE FROM messages WHERE mailbox_id = ? AND id = ?").run(mailboxId, draftRow.message_id);
+        // Keep the draft's thread row even when it becomes empty — send reuses
+        // old.threadId (Gmail draft send identity). removeEmptyThread here would
+        // drop solo-draft threads and force a new thread id on send.
+        addHistory(domain.db, mailboxId, draftRow.message_id, old.threadId, "draftSent");
+        return sendMessage(domain, email, raw, { threadId: old.threadId });
+    }).immediate();
+}
+export function deleteDraft(domain, email, draftId) {
+    const mailboxId = domain.mailboxId(email);
+    domain.db.transaction(() => {
+        const draftRow = requireDraft(domain, mailboxId, draftId);
+        const message = semanticMessage(domain.db, mailboxId, draftRow.message_id);
+        domain.db.prepare("DELETE FROM messages WHERE mailbox_id = ? AND id = ?").run(mailboxId, draftRow.message_id);
+        removeEmptyThread(domain, mailboxId, message.threadId);
+        addHistory(domain.db, mailboxId, draftRow.message_id, message.threadId, "draftDeleted");
+    }).immediate();
+}
+function requireDraft(domain, mailboxId, draftId) {
+    const row = domain.db
+        .prepare("SELECT * FROM drafts WHERE mailbox_id = ? AND id = ?")
+        .get(mailboxId, draftId);
+    if (!row)
+        notFound("Draft");
+    return row;
+}
+//# sourceMappingURL=drafts.js.map

package/node_modules/@pome-sh/twin-gmail/dist/src/domain/drafts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drafts.js","sourceRoot":"","sources":["../../../src/domain/drafts.ts"],"names":[],"mappings":"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"}

package/node_modules/@pome-sh/twin-gmail/dist/src/domain/filters.d.ts

@@ -0,0 +1,10 @@
+import type { GmailTwinDatabase, SeedFilter } from "../types.js";
+import type { GmailDomain } from "./gmail-domain.js";
+export type FilterResource = Required<Pick<SeedFilter, "criteria" | "action">> & {
+    id: string;
+};
+export declare function applyInboundFilters(db: GmailTwinDatabase, mailboxId: number, messageId: string): void;
+export declare function filters(domain: GmailDomain, email: string): FilterResource[];
+export declare function filter(domain: GmailDomain, email: string, filterId: string): FilterResource;
+export declare function createFilter(domain: GmailDomain, email: string, criteria?: SeedFilter["criteria"], action?: SeedFilter["action"]): FilterResource;
+export declare function deleteFilter(domain: GmailDomain, email: string, filterId: string): void;