pi-protonmail 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## Unreleased
+
+- Kept `/protonmail` as the single config command and moved Bridge/status/message handling into `protonmail_*` tools.
+- Replaced the Python Bridge helper with a native TypeScript module and kept attachment import staging under profile-specific workspaces.
+- Aligned the package metadata and docs with the Proton Mail workflow.

package/LICENSE

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

@@ -0,0 +1,67 @@
+# pi-protonmail
+
+Proton Mail Bridge Pi extension for mailbox discovery, message previews, attachment imports, and profile-based setup.
+
+## Use cases
+
+- `/protonmail` — open the interactive setup hub for profile defaults.
+- `protonmail_*` tools — check Bridge status, list mailboxes, preview messages, and import attachments.
+
+## Install
+
+```bash
+pi install npm:pi-protonmail
+```
+
+For local development:
+
+```bash
+pi install /absolute/path/to/this/repo
+```
+
+## Environment
+
+Set the Proton Bridge connection variables in your Pi environment:
+
+- `PROTON_BRIDGE_HOST`
+- `PROTON_BRIDGE_IMAP_PORT`
+- `PROTON_BRIDGE_SMTP_PORT`
+- `PROTON_BRIDGE_IMAP_SECURITY`
+- `PROTON_BRIDGE_USERNAME`
+- `PROTON_BRIDGE_PASSWORD`
+- `PROTON_BRIDGE_DEFAULT_MAILBOX` (optional)
+
+These values may be raw strings or 1Password references resolved by the extension.
+
+## Profiles and workspace
+
+Profile settings are stored under `.pi/protonmail/`:
+
+- `config.json` — workspace-level config
+- `profiles/<name>/policy.json` — per-profile defaults
+
+Profile defaults control the mailbox selection, mailbox filter, period, and optional import workspace override used by LLM-driven mail workflows. Attachment imports default to `.pi/protonmail/imports/<profile>/...`.
+
+## Workflow
+
+1. Configure Proton Bridge credentials.
+2. Open `/protonmail` to choose or edit a profile.
+3. Use `protonmail_*` tools for Bridge status, mailbox lookup, message previews, or staged attachment imports.
+
+## Publishing
+
+Tagged pushes like `v0.1.0` publish to npm through GitHub Actions. The release workflow validates the tag version, runs checks, and publishes with `NPM_TOKEN` when the version is not already on npm.
+
+## Repository notes
+
+- Entry point: `src/index.ts`
+- Main extension logic: `src/protonmail.ts`
+- Native Bridge implementation: `src/proton-bridge.ts`
+- Setup hub: `src/hub.ts`
+- Secret resolution: `src/secret-refs.ts`
+
+## Troubleshooting
+
+- If Bridge status fails, confirm the host, ports, and credentials are correct.
+- If list or import commands return nothing, verify the default mailbox and active profile policy.
+- If imports fail, check that the target period is set and matches `YYYY-MM`.

package/biome.json

@@ -0,0 +1,25 @@
+{
+	"$schema": "https://biomejs.dev/schemas/2.5.1/schema.json",
+	"files": {
+		"includes": ["**", "!!**/.pi"]
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "tab",
+		"lineWidth": 100
+	},
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"preset": "recommended"
+		}
+	},
+	"assist": {
+		"enabled": true,
+		"actions": {
+			"source": {
+				"organizeImports": "on"
+			}
+		}
+	}
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+	"name": "pi-protonmail",
+	"version": "0.1.0",
+	"type": "module",
+	"description": "Proton Mail Bridge Pi extension for mailbox discovery and attachment imports.",
+	"homepage": "https://github.com/eirenik0/pi-protonmail#readme",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/eirenik0/pi-protonmail.git"
+	},
+	"bugs": {
+		"url": "https://github.com/eirenik0/pi-protonmail/issues"
+	},
+	"author": "Serhii Khalymon <serhii.khalymon@pm.me>",
+	"license": "MIT",
+	"keywords": [
+		"pi-package",
+		"pi-extension",
+		"protonmail",
+		"proton-bridge"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"engines": {
+		"node": ">=24"
+	},
+	"pi": {
+		"extensions": [
+			"./src/index.ts"
+		]
+	},
+	"files": [
+		"src",
+		"README.md",
+		"CHANGELOG.md",
+		"LICENSE",
+		"package.json",
+		"biome.json"
+	],
+	"scripts": {
+		"lint": "biome lint .",
+		"format": "biome format --write .",
+		"format:check": "biome format .",
+		"check": "biome check .",
+		"check:docs": "lat check",
+		"prepublishOnly": "npm run check",
+		"fix": "biome check --write ."
+	},
+	"dependencies": {
+		"effect": "^3.0.0",
+		"imapflow": "^1.1.1",
+		"mailparser": "^3.9.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.5.0"
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-coding-agent": "*",
+		"@earendil-works/pi-tui": "*",
+		"typebox": "*"
+	}
+}

package/src/constants.ts

@@ -0,0 +1 @@
+export const PREVIEW_LINES = 8;