beanhub-cli 3.0.1__tar.gz → 3.1.1__tar.gz

{beanhub_cli-3.0.1 → beanhub_cli-3.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: beanhub-cli
-Version: 3.0.1
+Version: 3.1.1
 Summary: Command line tools for BeanHub and Beancount users
 Project-URL: Documentation, https://beanhub-cli-docs.beanhub.io
 Author-email: Fang-Pen Lin <fangpen@launchplatform.com>
@@ -9,6 +9,8 @@ License-File: LICENSE
 Requires-Python: ~=3.10
 Requires-Dist: attrs>=22.2.0
 Requires-Dist: beancount-black<2,>=1.0.1
+Requires-Dist: beancount-data>=3.0.2
+Requires-Dist: beancount-exporter>=3.0.0
 Requires-Dist: beancount-parser<1.3.0,>=1.2.3
 Requires-Dist: beanhub-extract<1.0.0,>=0.1.0
 Requires-Dist: beanhub-forms<0.2,>=0.1.3
@@ -16,9 +18,11 @@ Requires-Dist: beanhub-import<2.0.0,>=1.0.0
 Requires-Dist: beanhub-inbox<0.3.0,>=0.2.3
 Requires-Dist: click<9,>=8.1.7
 Requires-Dist: cryptography>=44.0.0
+Requires-Dist: fastapi-mcp>=0.3.7
 Requires-Dist: fastapi<1.0.0,>=0.98.0
 Requires-Dist: httpx<0.29.0,>=0.20.0
 Requires-Dist: jinja2<4.0.0,>=3.1.2
+Requires-Dist: orjson>=3.11.0
 Requires-Dist: pydantic-settings<3,>=2.0.3
 Requires-Dist: pydantic<3,>=2.4.0
 Requires-Dist: pynacl<2,>=1.5.0

{beanhub_cli-3.0.1 → beanhub_cli-3.1.1}/beanhub_cli/connect/main.py

@@ -55,6 +55,7 @@ def run_sync(env: Environment, config: AuthConfig):
         [
             PlaidItemSyncState.IMPORT_FAILED,
             PlaidItemSyncState.SYNC_FAILED,
+            PlaidItemSyncState.SKIPPED,
         ]
     )
 

{beanhub_cli-3.0.1 → beanhub_cli-3.1.1}/beanhub_cli/format.py

@@ -1,5 +1,6 @@
 import copy
 import functools
+import logging
 import pathlib
 import shutil
 import sys
@@ -115,54 +116,26 @@ def combine_transforms(
     return tree_or_token
 
 
-@cli.command(name="format", help="Format Beancount files with beancount-black")
-@click.argument("filename", type=click.Path(exists=False, dir_okay=False), nargs=-1)
-@click.option(
-    "--backup-suffix", type=str, default=".backup", help="suffix of backup file"
-)
-@click.option(
-    "-ra",
-    "--rename-account",
-    type=(str, str),
-    help="rename account names",
-    nargs=2,
-    multiple=True,
-)
-@click.option(
-    "-rc",
-    "--rename-currency",
-    type=(str, str),
-    help="rename currency names",
-    nargs=2,
-    multiple=True,
-)
-@click.option(
-    "-s",
-    "--stdin-mode",
-    is_flag=True,
-    help="Read beancount file data from stdin and output result to stdout",
-)
-@click.option("-b", "--backup", is_flag=True, help="Create backup file")
-@pass_env
-def main(
-    env: Environment,
-    filename: list[click.Path],
-    backup_suffix: str,
-    rename_account: list[tuple[str, str]],
-    rename_currency: list[tuple[str, str]],
-    stdin_mode: bool,
-    backup: bool,
+def format_beancount(
+    filenames: list[pathlib.Path],
+    backup_suffix: str = ".backup",
+    rename_account: list[tuple[str, str]] | None = None,
+    rename_currency: list[tuple[str, str]] | None = None,
+    stdin_mode: bool = False,
+    backup: bool = False,
+    logger: logging.Logger | None = None,
 ):
+    logger = logger or logging.getLogger(__name__)
     tree_transformers: list[typing.Callable] = []
     if rename_account:
         for from_val, to_val in rename_account:
-            env.logger.info("Renaming account from %s to %s", from_val, to_val)
+            logger.info("Renaming account from %s to %s", from_val, to_val)
         tree_transformers.append(
             functools.partial(rename_account_transform, dict(rename_account))
         )
     if rename_currency:
         for from_val, to_val in rename_currency:
-            env.logger.info("Renaming currency from %s to %s", from_val, to_val)
+            logger.info("Renaming currency from %s to %s", from_val, to_val)
         tree_transformers.append(
             functools.partial(rename_commodity_transform, dict(rename_currency))
         )
@@ -170,28 +143,28 @@ def main(
     # TODO: support follow include statements
     parser = make_parser()
     if stdin_mode:
-        env.logger.info("Processing in stdin mode")
+        logger.info("Processing in stdin mode")
         input_content = sys.stdin.read()
         tree = parser.parse(input_content)
         formatter = Formatter()
         formatter.format(tree, sys.stdout)
     else:
-        if filename:
+        if filenames:
             iterator = file_tree_iterator(
                 parser=parser,
-                filenames=map(lambda item: pathlib.Path(str(item)), filename),
+                filenames=filenames,
             )
         else:
-            env.logger.info("No files provided, traverse starting from main.bean")
+            logger.info("No files provided, traverse starting from main.bean")
             iterator = traverse(
                 parser=parser,
                 bean_file=pathlib.Path("main.bean"),
                 root_dir=pathlib.Path.cwd(),
             )
         for filepath, tree in iterator:
-            env.logger.info("Processing file %s", filepath)
+            logger.info("Processing file %s", filepath)
             if tree_transformers:
-                env.logger.info(
+                logger.info(
                     "Running %s transforms against file %s ...",
                     len(tree_transformers),
                     filepath,
@@ -207,14 +180,61 @@ def main(
                 output_content = output_file.read()
                 input_content = filepath.read_text()
                 if input_content == output_content:
-                    env.logger.info("File %s is not changed, skip", filepath)
+                    logger.info("File %s is not changed, skip", filepath)
                     continue
                 if backup:
                     backup_path = create_backup(src=filepath, suffix=backup_suffix)
-                    env.logger.info(
-                        "File %s changed, backup to %s", filepath, backup_path
-                    )
+                    logger.info("File %s changed, backup to %s", filepath, backup_path)
                 output_file.seek(0)
                 with open(filepath, "wt") as input_file:
                     shutil.copyfileobj(output_file, input_file)
-    env.logger.info("done")
+    logger.info("done")
+
+
+@cli.command(name="format", help="Format Beancount files with beancount-black")
+@click.argument("filename", type=click.Path(exists=False, dir_okay=False), nargs=-1)
+@click.option(
+    "--backup-suffix", type=str, default=".backup", help="suffix of backup file"
+)
+@click.option(
+    "-ra",
+    "--rename-account",
+    type=(str, str),
+    help="rename account names",
+    nargs=2,
+    multiple=True,
+)
+@click.option(
+    "-rc",
+    "--rename-currency",
+    type=(str, str),
+    help="rename currency names",
+    nargs=2,
+    multiple=True,
+)
+@click.option(
+    "-s",
+    "--stdin-mode",
+    is_flag=True,
+    help="Read beancount file data from stdin and output result to stdout",
+)
+@click.option("-b", "--backup", is_flag=True, help="Create backup file")
+@pass_env
+def main(
+    env: Environment,
+    filename: list[click.Path],
+    backup_suffix: str,
+    rename_account: list[tuple[str, str]],
+    rename_currency: list[tuple[str, str]],
+    stdin_mode: bool,
+    backup: bool,
+):
+    format_beancount(
+        filenames=list(map(lambda item: pathlib.Path(str(item)), filename)),
+        backup_suffix=backup_suffix,
+        rename_account=rename_account,
+        rename_currency=rename_currency,
+        stdin_mode=stdin_mode,
+        backup=backup,
+        logger=env.logger,
+    )

{beanhub_cli-3.0.1 → beanhub_cli-3.1.1}/beanhub_cli/internal_api/models/plaid_item_sync_state.py

@@ -7,6 +7,7 @@ class PlaidItemSyncState(str, Enum):
     IMPORT_FAILED = "IMPORT_FAILED"
     PENDING = "PENDING"
     PROCESSING = "PROCESSING"
+    SKIPPED = "SKIPPED"
     SYNC_COMPLETE = "SYNC_COMPLETE"
     SYNC_FAILED = "SYNC_FAILED"
 

{beanhub_cli-3.0.1 → beanhub_cli-3.1.1}/beanhub_cli/main.py

@@ -5,6 +5,7 @@ from .forms import main as forms  # noqa
 from .import_cli import main as import_cli  # noqa
 from .inbox import main as inbox  # noqa
 from .login import main as login  # noqa
+from .mcp import main as mcp  # noqa
 
 __ALL__ = [cli]
 

beanhub_cli-3.1.1/beanhub_cli/mcp/app/main.py

@@ -0,0 +1,16 @@
+from fastapi import FastAPI
+from fastapi_mcp import FastApiMCP
+
+from .routes import router
+
+
+def make_app() -> FastAPI:
+    app = FastAPI(
+        openapi_url="",
+        docs_url=None,
+        redoc_url=None,
+    )
+    app.include_router(router)
+    mcp = FastApiMCP(app)
+    mcp.mount()
+    return app

beanhub_cli-3.1.1/beanhub_cli/mcp/app/routes.py

@@ -0,0 +1,62 @@
+import json
+import logging
+import pathlib
+import subprocess
+import sys
+
+from beancount_data.data_types import EntryUnion
+from beancount_data.data_types import ValidationResult
+from fastapi import APIRouter
+from fastapi import Request
+from pydantic import TypeAdapter
+
+from ...format import format_beancount
+from ..schemes import ExportBeancountResult
+from ..schemes import FormatResult
+
+router = APIRouter()
+logger = logging.getLogger(__name__)
+entry_adapter = TypeAdapter(EntryUnion)
+
+
+@router.get(
+    "/entries",
+    response_model=ExportBeancountResult,
+    operation_id="list-entries",
+    description="List all Beancount entries for the given Beancount file",
+)
+async def list_entries(
+    request: Request, beancount_file: str = "main.bean"
+) -> ExportBeancountResult:
+    proc = subprocess.run(
+        (sys.executable, "-m", "beancount_exporter.main", beancount_file),
+        timeout=10,
+        capture_output=True,
+    )
+    lines = proc.stdout.splitlines()
+    result = ExportBeancountResult(
+        ok=proc.returncode == 0,
+        error=proc.stderr.decode("utf8"),
+    )
+    if proc.returncode == 0:
+        result.options = json.loads(lines[0])
+        result.validation_result = ValidationResult.model_validate_json(lines[2])
+        result.entries = list(map(entry_adapter.validate_json, lines[4:]))
+    else:
+        logger.error("Failed to export entries: %s", result.error)
+    return result
+
+
+@router.get(
+    "/format",
+    response_model=FormatResult,
+    operation_id="format-beancount-file",
+    description="Format beancount files",
+)
+async def format_beancount_file(
+    request: Request, beancount_file: str = "main.bean"
+) -> FormatResult:
+    format_beancount(filenames=[pathlib.Path(beancount_file)])
+    return FormatResult(
+        ok=True,
+    )

beanhub_cli-3.1.1/beanhub_cli/mcp/cli.py

@@ -0,0 +1,10 @@
+from ..aliase import AliasedGroup
+from ..cli import cli as root_cli
+
+
+@root_cli.group(
+    name="mcp",
+    help="Run Model Context Protocol (MCP) server for LLM to access your Beancount books",
+)
+def cli():
+    pass

beanhub_cli-3.1.1/beanhub_cli/mcp/main.py

@@ -0,0 +1,38 @@
+import click
+import uvicorn
+
+from ..environment import Environment
+from ..environment import pass_env
+from .app.main import make_app
+from .cli import cli
+
+
+@cli.command(name="server", help="Run a web server for the MCP service")
+@click.option(
+    "-p",
+    "--port",
+    type=int,
+    default=8080,
+    show_default=True,
+    help="Port number for serving the MCP web app.",
+)
+@click.option(
+    "-h",
+    "--host",
+    type=str,
+    default="127.0.0.1",
+    show_default=True,
+    help="Host for serving the MCP web app.",
+)
+@click.option(
+    "--uvicorn-log-level",
+    default="info",
+    show_default=True,
+    help="Log level for Uvicorn web server.",
+)
+@pass_env
+def run_server(env: Environment, port: int, host: str, uvicorn_log_level: str):
+    app = make_app()
+    config = uvicorn.Config(app=app, port=port, host=host, log_level=uvicorn_log_level)
+    server = uvicorn.Server(config=config)
+    server.run()

beanhub_cli-3.1.1/beanhub_cli/mcp/schemes.py

@@ -0,0 +1,20 @@
+import typing
+
+from beancount_data.data_types import EntryUnion
+from beancount_data.data_types import ValidationResult
+from pydantic import BaseModel
+
+
+class ResultBase(BaseModel):
+    ok: bool
+    error: typing.Optional[str] = None
+
+
+class ExportBeancountResult(ResultBase):
+    options: typing.Optional[typing.Dict[str, typing.Any]] = None
+    validation_result: typing.Optional[ValidationResult] = None
+    entries: typing.Optional[EntryUnion] = None
+
+
+class FormatResult(ResultBase):
+    pass

{beanhub_cli-3.0.1 → beanhub_cli-3.1.1}/data/internal-openapi.json

@@ -1 +1 @@
-{"openapi": "3.1.0", "info": {"title": "BeanHub Internal API", "description": "The BeanHub API for public access but not published yet, so they are subject to changes. Please do not rely on it.", "version": "0.0.1"}, "paths": {"/v1/auth/sessions": {"post": {"tags": ["auth"], "summary": "Create auth session", "operationId": "create_auth_session", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/AuthSessionRequest"}}}, "required": true}, "responses": {"201": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AuthSessionResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/auth/sessions/{auth_session_id}/poll": {"get": {"tags": ["auth"], "summary": "Poll auth session status", "operationId": "poll_auth_session", "parameters": [{"name": "auth_session_id", "in": "path", "required": true, "schema": {"type": "string", "format": "uuid", "title": "Auth Session Id"}}, {"name": "secret_token", "in": "query", "required": true, "schema": {"type": "string", "title": "Secret Token"}}], "responses": {"200": {"description": "Auth session is ready", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AuthSessionPollResponse"}, "example": {"token": "5308cd91-d7d7-488c-b9a9-ed984f58c01b", "repositories": ["username/repo"]}}}}, "202": {"description": "Not granted yet, please try again later", "content": {"application/json": {"example": {"code": "try_again", "message": "still waiting for auth"}, "schema": {"$ref": "#/components/schemas/AuthSessionNotReadyResponse"}}}}, "404": {"description": "Auth session not found", "content": {"application/json": {"example": {"detail": "Auth session not found"}, "schema": {"$ref": "#/components/schemas/GenericError"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/connect/sync_batches": {"post": {"tags": ["connect"], "summary": "Create a sync batch", "operationId": "create_sync_batch", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "responses": {"201": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateSyncBatchResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/connect/sync_batches/{sync_batch_id}": {"get": {"tags": ["connect"], "summary": "Get a sync batch", "operationId": "get_sync_batch", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "sync_batch_id", "in": "path", "required": true, "schema": {"type": "string", "format": "uuid", "title": "Sync Batch Id"}}, {"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetSyncBatchResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/connect/dumps": {"post": {"tags": ["connect"], "summary": "Create a dump request", "operationId": "create_dump_request", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateDumpRequestRequest"}}}}, "responses": {"201": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateDumpRequestResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/connect/dumps/{dump_request_id}": {"get": {"tags": ["connect"], "summary": "Get a dump request", "operationId": "get_dump_request", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "dump_request_id", "in": "path", "required": true, "schema": {"type": "string", "format": "uuid", "title": "Dump Request Id"}}, {"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetDumpRequestResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/inbox/emails": {"get": {"tags": ["inbox"], "summary": "Get inbox emails", "operationId": "get_inbox_emails", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}, {"name": "cursor", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Cursor"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetInboxEmailResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/inbox/dumps": {"post": {"tags": ["inbox"], "summary": "Create an inbox dump request", "operationId": "create_inbox_dump_request", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateInboxDumpRequest"}}}}, "responses": {"201": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateInboxDumpRequestResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/inbox/dumps/{dump_request_id}": {"get": {"tags": ["inbox"], "summary": "Get an inbox dump request", "operationId": "get_inbox_dump_request", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "dump_request_id", "in": "path", "required": true, "schema": {"type": "string", "format": "uuid", "title": "Dump Request Id"}}, {"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetInboxDumpRequestResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repositories": {"get": {"tags": ["repo"], "summary": "List repositories", "operationId": "list_repo", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListRepositoriesResponse"}}}}}, "security": [{"APIKeyHeader": []}]}}}, "components": {"schemas": {"AuthSessionNotReadyResponse": {"properties": {"code": {"type": "string", "title": "Code"}, "message": {"type": "string", "title": "Message"}}, "type": "object", "required": ["code", "message"], "title": "AuthSessionNotReadyResponse"}, "AuthSessionPollResponse": {"properties": {"token": {"type": "string", "title": "Token"}, "repositories": {"anyOf": [{"items": {"type": "string"}, "type": "array"}, {"type": "null"}], "title": "Repositories", "deprecated": true}}, "type": "object", "required": ["token"], "title": "AuthSessionPollResponse"}, "AuthSessionRequest": {"properties": {"hostname": {"type": "string", "title": "Hostname"}}, "type": "object", "required": ["hostname"], "title": "AuthSessionRequest"}, "AuthSessionResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}, "code": {"type": "string", "title": "Code"}, "auth_url": {"type": "string", "title": "Auth Url"}, "secret_token": {"type": "string", "title": "Secret Token"}, "poll_url": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Poll Url", "deprecated": true}}, "type": "object", "required": ["id", "code", "auth_url", "secret_token"], "title": "AuthSessionResponse"}, "CreateDumpRequestRequest": {"properties": {"public_key": {"type": "string", "title": "Public Key"}, "output_accounts": {"type": "boolean", "title": "Output Accounts", "default": false}}, "type": "object", "required": ["public_key"], "title": "CreateDumpRequestRequest"}, "CreateDumpRequestResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}}, "type": "object", "required": ["id"], "title": "CreateDumpRequestResponse"}, "CreateInboxDumpRequest": {"properties": {"public_key": {"type": "string", "title": "Public Key"}, "email_ids": {"items": {"type": "string"}, "type": "array", "title": "Email Ids"}}, "type": "object", "required": ["public_key", "email_ids"], "title": "CreateInboxDumpRequest"}, "CreateInboxDumpRequestResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}}, "type": "object", "required": ["id"], "title": "CreateInboxDumpRequestResponse"}, "CreateSyncBatchResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}}, "type": "object", "required": ["id"], "title": "CreateSyncBatchResponse"}, "DumpRequestState": {"type": "string", "enum": ["PENDING", "PROCESSING", "COMPLETE", "FAILED"], "title": "DumpRequestState"}, "GenericError": {"properties": {"detail": {"title": "Detail"}}, "type": "object", "title": "GenericError"}, "GetDumpRequestResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}, "state": {"$ref": "#/components/schemas/DumpRequestState"}, "encryption_key": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Encryption Key"}, "download_url": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Download Url"}, "accounts_download_url": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Accounts Download Url"}, "error_message": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Error Message"}}, "type": "object", "required": ["id", "state"], "title": "GetDumpRequestResponse"}, "GetInboxDumpRequestResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}, "state": {"$ref": "#/components/schemas/InboxDumpRequestState"}, "encryption_key": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Encryption Key"}, "download_url": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Download Url"}, "error_message": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Error Message"}}, "type": "object", "required": ["id", "state"], "title": "GetInboxDumpRequestResponse"}, "GetInboxEmailResponse": {"properties": {"emails": {"items": {"$ref": "#/components/schemas/InboxEmail"}, "type": "array", "title": "Emails"}, "cursor": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Cursor"}}, "type": "object", "required": ["emails"], "title": "GetInboxEmailResponse"}, "GetSyncBatchResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}, "syncs": {"items": {"$ref": "#/components/schemas/SyncData"}, "type": "array", "title": "Syncs"}}, "type": "object", "required": ["id", "syncs"], "title": "GetSyncBatchResponse"}, "HTTPValidationError": {"properties": {"detail": {"items": {"$ref": "#/components/schemas/ValidationError"}, "type": "array", "title": "Detail"}}, "type": "object", "title": "HTTPValidationError"}, "InboxDumpRequestState": {"type": "string", "enum": ["PENDING", "PROCESSING", "COMPLETE", "FAILED"], "title": "InboxDumpRequestState"}, "InboxEmail": {"properties": {"id": {"type": "string", "title": "Id"}, "message_id": {"type": "string", "title": "Message Id"}, "headers": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Headers"}, "subject": {"type": "string", "title": "Subject"}, "from_addresses": {"items": {"type": "string"}, "type": "array", "title": "From Addresses"}, "recipients": {"items": {"type": "string"}, "type": "array", "title": "Recipients"}, "tags": {"anyOf": [{"items": {"type": "string"}, "type": "array"}, {"type": "null"}], "title": "Tags"}}, "type": "object", "required": ["id", "message_id", "headers", "subject", "from_addresses", "recipients"], "title": "InboxEmail"}, "ItemData": {"properties": {"id": {"type": "string", "title": "Id"}, "institution_name": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Institution Name"}}, "type": "object", "required": ["id", "institution_name"], "title": "ItemData"}, "ListRepositoriesResponse": {"properties": {"repositories": {"items": {"$ref": "#/components/schemas/Repository"}, "type": "array", "title": "Repositories"}}, "type": "object", "required": ["repositories"], "title": "ListRepositoriesResponse"}, "PlaidItemSyncState": {"type": "string", "enum": ["PENDING", "PROCESSING", "SYNC_COMPLETE", "SYNC_FAILED", "IMPORT_COMPLETE", "IMPORT_COMPLETE_NO_CHANGES", "IMPORT_FAILED"], "title": "PlaidItemSyncState"}, "Repository": {"properties": {"username": {"type": "string", "title": "Username"}, "name": {"type": "string", "title": "Name"}, "type": {"$ref": "#/components/schemas/RepositoryType"}, "public": {"type": "boolean", "title": "Public"}, "active": {"type": "boolean", "title": "Active"}}, "type": "object", "required": ["username", "name", "type", "public", "active"], "title": "Repository"}, "RepositoryType": {"type": "string", "enum": ["GIT", "CONNECT"], "title": "RepositoryType"}, "SyncData": {"properties": {"id": {"type": "string", "title": "Id"}, "state": {"$ref": "#/components/schemas/PlaidItemSyncState"}, "error_message": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Error Message"}, "item": {"$ref": "#/components/schemas/ItemData"}}, "type": "object", "required": ["id", "state", "item"], "title": "SyncData"}, "ValidationError": {"properties": {"loc": {"items": {"anyOf": [{"type": "string"}, {"type": "integer"}]}, "type": "array", "title": "Location"}, "msg": {"type": "string", "title": "Message"}, "type": {"type": "string", "title": "Error Type"}}, "type": "object", "required": ["loc", "msg", "type"], "title": "ValidationError"}}, "securitySchemes": {"APIKeyHeader": {"type": "apiKey", "in": "header", "name": "access-token"}}}}
+{"openapi": "3.1.0", "info": {"title": "BeanHub Internal API", "description": "The BeanHub API for public access but not published yet, so they are subject to changes. Please do not rely on it.", "version": "0.0.1"}, "paths": {"/v1/auth/sessions": {"post": {"tags": ["auth"], "summary": "Create auth session", "operationId": "create_auth_session", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/AuthSessionRequest"}}}, "required": true}, "responses": {"201": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AuthSessionResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/auth/sessions/{auth_session_id}/poll": {"get": {"tags": ["auth"], "summary": "Poll auth session status", "operationId": "poll_auth_session", "parameters": [{"name": "auth_session_id", "in": "path", "required": true, "schema": {"type": "string", "format": "uuid", "title": "Auth Session Id"}}, {"name": "secret_token", "in": "query", "required": true, "schema": {"type": "string", "title": "Secret Token"}}], "responses": {"200": {"description": "Auth session is ready", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AuthSessionPollResponse"}, "example": {"token": "5308cd91-d7d7-488c-b9a9-ed984f58c01b", "repositories": ["username/repo"]}}}}, "202": {"description": "Not granted yet, please try again later", "content": {"application/json": {"example": {"code": "try_again", "message": "still waiting for auth"}, "schema": {"$ref": "#/components/schemas/AuthSessionNotReadyResponse"}}}}, "404": {"description": "Auth session not found", "content": {"application/json": {"example": {"detail": "Auth session not found"}, "schema": {"$ref": "#/components/schemas/GenericError"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/connect/sync_batches": {"post": {"tags": ["connect"], "summary": "Create a sync batch", "operationId": "create_sync_batch", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "responses": {"201": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateSyncBatchResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/connect/sync_batches/{sync_batch_id}": {"get": {"tags": ["connect"], "summary": "Get a sync batch", "operationId": "get_sync_batch", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "sync_batch_id", "in": "path", "required": true, "schema": {"type": "string", "format": "uuid", "title": "Sync Batch Id"}}, {"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetSyncBatchResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/connect/dumps": {"post": {"tags": ["connect"], "summary": "Create a dump request", "operationId": "create_dump_request", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateDumpRequestRequest"}}}}, "responses": {"201": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateDumpRequestResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/connect/dumps/{dump_request_id}": {"get": {"tags": ["connect"], "summary": "Get a dump request", "operationId": "get_dump_request", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "dump_request_id", "in": "path", "required": true, "schema": {"type": "string", "format": "uuid", "title": "Dump Request Id"}}, {"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetDumpRequestResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/inbox/emails": {"get": {"tags": ["inbox"], "summary": "Get inbox emails", "operationId": "get_inbox_emails", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}, {"name": "cursor", "in": "query", "required": false, "schema": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Cursor"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetInboxEmailResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/inbox/dumps": {"post": {"tags": ["inbox"], "summary": "Create an inbox dump request", "operationId": "create_inbox_dump_request", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateInboxDumpRequest"}}}}, "responses": {"201": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CreateInboxDumpRequestResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repos/{username}/{repo_name}/inbox/dumps/{dump_request_id}": {"get": {"tags": ["inbox"], "summary": "Get an inbox dump request", "operationId": "get_inbox_dump_request", "security": [{"APIKeyHeader": []}], "parameters": [{"name": "dump_request_id", "in": "path", "required": true, "schema": {"type": "string", "format": "uuid", "title": "Dump Request Id"}}, {"name": "username", "in": "path", "required": true, "schema": {"type": "string", "title": "Username"}}, {"name": "repo_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Repo Name"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/GetInboxDumpRequestResponse"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/v1/repositories": {"get": {"tags": ["repo"], "summary": "List repositories", "operationId": "list_repo", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ListRepositoriesResponse"}}}}}, "security": [{"APIKeyHeader": []}]}}}, "components": {"schemas": {"AuthSessionNotReadyResponse": {"properties": {"code": {"type": "string", "title": "Code"}, "message": {"type": "string", "title": "Message"}}, "type": "object", "required": ["code", "message"], "title": "AuthSessionNotReadyResponse"}, "AuthSessionPollResponse": {"properties": {"token": {"type": "string", "title": "Token"}, "repositories": {"anyOf": [{"items": {"type": "string"}, "type": "array"}, {"type": "null"}], "title": "Repositories", "deprecated": true}}, "type": "object", "required": ["token"], "title": "AuthSessionPollResponse"}, "AuthSessionRequest": {"properties": {"hostname": {"type": "string", "title": "Hostname"}}, "type": "object", "required": ["hostname"], "title": "AuthSessionRequest"}, "AuthSessionResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}, "code": {"type": "string", "title": "Code"}, "auth_url": {"type": "string", "title": "Auth Url"}, "secret_token": {"type": "string", "title": "Secret Token"}, "poll_url": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Poll Url", "deprecated": true}}, "type": "object", "required": ["id", "code", "auth_url", "secret_token"], "title": "AuthSessionResponse"}, "CreateDumpRequestRequest": {"properties": {"public_key": {"type": "string", "title": "Public Key"}, "output_accounts": {"type": "boolean", "title": "Output Accounts", "default": false}}, "type": "object", "required": ["public_key"], "title": "CreateDumpRequestRequest"}, "CreateDumpRequestResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}}, "type": "object", "required": ["id"], "title": "CreateDumpRequestResponse"}, "CreateInboxDumpRequest": {"properties": {"public_key": {"type": "string", "title": "Public Key"}, "email_ids": {"items": {"type": "string"}, "type": "array", "minItems": 1, "title": "Email Ids"}}, "type": "object", "required": ["public_key", "email_ids"], "title": "CreateInboxDumpRequest"}, "CreateInboxDumpRequestResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}}, "type": "object", "required": ["id"], "title": "CreateInboxDumpRequestResponse"}, "CreateSyncBatchResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}}, "type": "object", "required": ["id"], "title": "CreateSyncBatchResponse"}, "DumpRequestState": {"type": "string", "enum": ["PENDING", "PROCESSING", "COMPLETE", "FAILED"], "title": "DumpRequestState"}, "GenericError": {"properties": {"detail": {"title": "Detail"}}, "type": "object", "title": "GenericError"}, "GetDumpRequestResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}, "state": {"$ref": "#/components/schemas/DumpRequestState"}, "encryption_key": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Encryption Key"}, "download_url": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Download Url"}, "accounts_download_url": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Accounts Download Url"}, "error_message": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Error Message"}}, "type": "object", "required": ["id", "state"], "title": "GetDumpRequestResponse"}, "GetInboxDumpRequestResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}, "state": {"$ref": "#/components/schemas/InboxDumpRequestState"}, "encryption_key": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Encryption Key"}, "download_url": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Download Url"}, "error_message": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Error Message"}}, "type": "object", "required": ["id", "state"], "title": "GetInboxDumpRequestResponse"}, "GetInboxEmailResponse": {"properties": {"emails": {"items": {"$ref": "#/components/schemas/InboxEmail"}, "type": "array", "title": "Emails"}, "cursor": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Cursor"}}, "type": "object", "required": ["emails"], "title": "GetInboxEmailResponse"}, "GetSyncBatchResponse": {"properties": {"id": {"type": "string", "format": "uuid", "title": "Id"}, "syncs": {"items": {"$ref": "#/components/schemas/SyncData"}, "type": "array", "title": "Syncs"}}, "type": "object", "required": ["id", "syncs"], "title": "GetSyncBatchResponse"}, "HTTPValidationError": {"properties": {"detail": {"items": {"$ref": "#/components/schemas/ValidationError"}, "type": "array", "title": "Detail"}}, "type": "object", "title": "HTTPValidationError"}, "InboxDumpRequestState": {"type": "string", "enum": ["PENDING", "PROCESSING", "COMPLETE", "FAILED"], "title": "InboxDumpRequestState"}, "InboxEmail": {"properties": {"id": {"type": "string", "title": "Id"}, "message_id": {"type": "string", "title": "Message Id"}, "headers": {"additionalProperties": {"type": "string"}, "type": "object", "title": "Headers"}, "subject": {"type": "string", "title": "Subject"}, "from_addresses": {"items": {"type": "string"}, "type": "array", "title": "From Addresses"}, "recipients": {"items": {"type": "string"}, "type": "array", "title": "Recipients"}, "tags": {"anyOf": [{"items": {"type": "string"}, "type": "array"}, {"type": "null"}], "title": "Tags"}}, "type": "object", "required": ["id", "message_id", "headers", "subject", "from_addresses", "recipients"], "title": "InboxEmail"}, "ItemData": {"properties": {"id": {"type": "string", "title": "Id"}, "institution_name": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Institution Name"}}, "type": "object", "required": ["id", "institution_name"], "title": "ItemData"}, "ListRepositoriesResponse": {"properties": {"repositories": {"items": {"$ref": "#/components/schemas/Repository"}, "type": "array", "title": "Repositories"}}, "type": "object", "required": ["repositories"], "title": "ListRepositoriesResponse"}, "PlaidItemSyncState": {"type": "string", "enum": ["PENDING", "PROCESSING", "SYNC_COMPLETE", "SYNC_FAILED", "IMPORT_COMPLETE", "IMPORT_COMPLETE_NO_CHANGES", "IMPORT_FAILED", "SKIPPED"], "title": "PlaidItemSyncState"}, "Repository": {"properties": {"username": {"type": "string", "title": "Username"}, "name": {"type": "string", "title": "Name"}, "type": {"$ref": "#/components/schemas/RepositoryType"}, "public": {"type": "boolean", "title": "Public"}, "active": {"type": "boolean", "title": "Active"}}, "type": "object", "required": ["username", "name", "type", "public", "active"], "title": "Repository"}, "RepositoryType": {"type": "string", "enum": ["GIT", "CONNECT"], "title": "RepositoryType"}, "SyncData": {"properties": {"id": {"type": "string", "title": "Id"}, "state": {"$ref": "#/components/schemas/PlaidItemSyncState"}, "error_message": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Error Message"}, "item": {"$ref": "#/components/schemas/ItemData"}}, "type": "object", "required": ["id", "state", "item"], "title": "SyncData"}, "ValidationError": {"properties": {"loc": {"items": {"anyOf": [{"type": "string"}, {"type": "integer"}]}, "type": "array", "title": "Location"}, "msg": {"type": "string", "title": "Message"}, "type": {"type": "string", "title": "Error Type"}}, "type": "object", "required": ["loc", "msg", "type"], "title": "ValidationError"}}, "securitySchemes": {"APIKeyHeader": {"type": "apiKey", "in": "header", "name": "access-token"}}}}

{beanhub_cli-3.0.1 → beanhub_cli-3.1.1}/docs/docs/commands/connect.md

@@ -10,13 +10,6 @@ Originally, this feature imports data as Git commits only to BeanHub's repositor
 Later on, we added the standalone commands to make it possible to pull bank transactions directly into your local work environment without relying on updates in BeanHub's Git repository.
 You can read our blog post [Direct Connect: Pulling transactions as CSV files from banks via Plaid directly](https://beanhub.io/blog/2025/01/16/direct-connect-repository/) to learn more.
 
-Please note that connect commands require some extra optional Python dependencies.
-Therefore, when installing BeanHub-CLI Python package, please make sure to include `connect` extra dependencies like this:
-
-```bash
-pip install "beanhub-cli[connect]"
-```
-
 ## Pre-requirements
 
 To pull transaction data from your bank automatically, you need to first log into your BeanHub account on our web app and then go to your repository.

{beanhub_cli-3.0.1 → beanhub_cli-3.1.1}/docs/docs/commands/login.md

@@ -4,13 +4,6 @@ We provide BeanHub-CLI as a standalone tool to work without a [BeanHub](https://
 However, some features are for paid BeanHub members only and require access to your BeanHub account, such as [BeanHub Connect](https://beanhub.io/blog/2024/06/24/introduction-of-beanhub-connect/)'s sync and dump.
 For those operations, you need to run the login command first.
 
-Please note that BeanHub-CLI login command requires some extra optional Python dependencies.
-Therefore, when installing BeanHub-CLI Python package, please make sure to include `login` extra dependencies like this:
-
-```bash
-pip install "beanhub-cli[login]"
-```
-
 It's very easy to log in to your BeanHub account with BeanHub-CLI. Simply run:
 
 ```bash

{beanhub_cli-3.0.1 → beanhub_cli-3.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "beanhub-cli"
-version = "3.0.1"
+version = "3.1.1"
 description = "Command line tools for BeanHub and Beancount users"
 authors = [{ name = "Fang-Pen Lin", email = "fangpen@launchplatform.com" }]
 requires-python = "~=3.10"
@@ -27,8 +27,12 @@ dependencies = [
     "beanhub-import>= 1.0.0, <2.0.0",
     "beanhub-extract>= 0.1.0, <1.0.0",
     "beancount-parser>= 1.2.3, <1.3.0",
-    "beanhub-inbox>=0.2.3, <0.3.0",
+    "beanhub-inbox>=0.2.3,<0.3.0",
     "cryptography>=44.0.0",
+    "fastapi-mcp>=0.3.7",
+    "beancount-data>=3.0.2",
+    "beancount-exporter>=3.0.0",
+    "orjson>=3.11.0",
 ]
 
 [project.urls]

{beanhub_cli-3.0.1 → beanhub_cli-3.1.1}/tests/connect/test_sync.py

@@ -82,6 +82,82 @@ def test_sync(
     assert result.exit_code == 0
 
 
+def test_sync_with_skipped_state(
+    cli_runner: CliRunner,
+    mock_config: Config,
+    httpx_mock: HTTPXMock,
+):
+    batch_id = uuid.uuid4()
+    httpx_mock.add_response(
+        url=f"https://api.beanhub.io/v1/repos/{mock_config.repo.default}/connect/sync_batches",
+        method="POST",
+        status_code=201,
+        json=dict(
+            id=str(batch_id),
+        ),
+        match_headers={"access-token": mock_config.access_token.token},
+    )
+    httpx_mock.add_response(
+        url=f"https://api.beanhub.io/v1/repos/{mock_config.repo.default}/connect/sync_batches/{batch_id}",
+        method="GET",
+        status_code=200,
+        json=dict(
+            id=str(batch_id),
+            syncs=[
+                dict(
+                    id="SYNC0",
+                    state="PROCESSING",
+                    item=dict(
+                        id="MOCK_ITEM0",
+                        institution_name="Chase",
+                    ),
+                ),
+                dict(
+                    id="SYNC1",
+                    state="PROCESSING",
+                    item=dict(
+                        id="MOCK_ITEM1",
+                        institution_name="Chase",
+                    ),
+                ),
+            ],
+        ),
+        match_headers={"access-token": mock_config.access_token.token},
+    )
+    httpx_mock.add_response(
+        url=f"https://api.beanhub.io/v1/repos/{mock_config.repo.default}/connect/sync_batches/{batch_id}",
+        method="GET",
+        status_code=200,
+        json=dict(
+            id=str(batch_id),
+            syncs=[
+                dict(
+                    id="SYNC0",
+                    state="IMPORT_COMPLETE_NO_CHANGES",
+                    item=dict(
+                        id="MOCK_ITEM0",
+                        institution_name="Chase",
+                    ),
+                ),
+                dict(
+                    id="SYNC1",
+                    state="SKIPPED",
+                    item=dict(
+                        id="MOCK_ITEM1",
+                        institution_name="Chase",
+                    ),
+                    error_message='Your login session has expired, please use the "Update" button to login to your bank account with Plaid again',
+                ),
+            ],
+        ),
+        match_headers={"access-token": mock_config.access_token.token},
+    )
+    cli_runner.mix_stderr = False
+    result = cli_runner.invoke(cli, ["connect", "sync"])
+    assert result.exit_code == 0
+    assert "Your login session has expired" in result.stdout.replace("\n", "")
+
+
 def test_sync_not_logged_in(
     cli_runner: CliRunner,
     mock_home: pathlib.Path,