abstractcore 2.20.2__tar.gz → 2.22.0__tar.gz

{abstractcore-2.20.2 → abstractcore-2.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractcore
-Version: 2.20.2
+Version: 2.22.0
 Summary: Unified interface to all LLM providers with essential infrastructure for tool calling, streaming, and model management
 Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
 Maintainer-email: Laurent-Philippe Albou <contact@abstractcore.ai>
@@ -455,7 +455,7 @@ You can also persist settings (including API keys) via the config CLI:
 - Embeddings and semantic search → [Embeddings](docs/embeddings.md)
 - Observability: global event bus + interaction traces → [Architecture](docs/architecture.md), [API Reference (Events)](docs/api-reference.md#eventtype), [Interaction Tracing](docs/interaction-tracing.md)
 - MCP (Model Context Protocol): discover tools from MCP servers (HTTP/stdio) → [MCP](docs/mcp.md)
-- Email: one IMAP/SMTP account (password or OAuth2), encrypted credentials, recipient policy, send limits, read-only mailbox and email tools → [Email](docs/email.md)
+- Email: one IMAP/SMTP account (password or OAuth2; servers found from the address), encrypted credentials, recipient policy, send limits, read-only mailbox and email tools → [Email](docs/email.md)
 - OpenAI-compatible server: one `/v1` gateway for chat + optional `/v1/images/*` and `/v1/audio/*` endpoints → [Server](docs/server.md)
 
 ## Tool calling (passthrough by default)
@@ -728,8 +728,7 @@ abstractcore engines install ollama --dry-run    # the exact install command
 Email (see [Email](docs/email.md)):
 
 ```bash
-abstractcore email connect --address me@example.com \
-  --imap-host imap.example.com --smtp-host smtp.example.com --password <value>
+abstractcore email connect --address me@example.com --password <value>   # servers found from the address
 abstractcore email test
 abstractcore email status
 ```

{abstractcore-2.20.2 → abstractcore-2.22.0}/README.md

@@ -270,7 +270,7 @@ You can also persist settings (including API keys) via the config CLI:
 - Embeddings and semantic search → [Embeddings](docs/embeddings.md)
 - Observability: global event bus + interaction traces → [Architecture](docs/architecture.md), [API Reference (Events)](docs/api-reference.md#eventtype), [Interaction Tracing](docs/interaction-tracing.md)
 - MCP (Model Context Protocol): discover tools from MCP servers (HTTP/stdio) → [MCP](docs/mcp.md)
-- Email: one IMAP/SMTP account (password or OAuth2), encrypted credentials, recipient policy, send limits, read-only mailbox and email tools → [Email](docs/email.md)
+- Email: one IMAP/SMTP account (password or OAuth2; servers found from the address), encrypted credentials, recipient policy, send limits, read-only mailbox and email tools → [Email](docs/email.md)
 - OpenAI-compatible server: one `/v1` gateway for chat + optional `/v1/images/*` and `/v1/audio/*` endpoints → [Server](docs/server.md)
 
 ## Tool calling (passthrough by default)
@@ -543,8 +543,7 @@ abstractcore engines install ollama --dry-run    # the exact install command
 Email (see [Email](docs/email.md)):
 
 ```bash
-abstractcore email connect --address me@example.com \
-  --imap-host imap.example.com --smtp-host smtp.example.com --password <value>
+abstractcore email connect --address me@example.com --password <value>   # servers found from the address
 abstractcore email test
 abstractcore email status
 ```

{abstractcore-2.20.2 → abstractcore-2.22.0}/abstractcore/assets/model_downloads_catalog.json

@@ -2,7 +2,7 @@
  "$schema": "./model_downloads_catalog.schema.json",
  "schema": "model_downloads_catalog_v1",
  "version": "2026-09-29",
- "notes": "Curated download catalog. Sizes are bytes observed in real engine stores/caches (size_source=catalog) or null (unknown). verified=true means the artifact id was seen on a real engine or cache when the seed was built; other ids follow each engine's naming convention and are checked by presence probes and by the post-download verification in model_materializer. upstream={method, checked, revision?} records an id verified to exist upstream on that date (hf_api: HfApi.model_info(files_metadata=True), download_bytes = the weight files; ollama_registry: the registry manifest, download_bytes = the sum of its layers); such an artifact must carry its verified size. options carries route options the recommendation copies (the MTP builds: speculation). resident={bytes, source} (optional, per artifact) is the MEASURED memory the engine needs while it runs, for models whose working memory is not their file size (video generation): the fit verdict uses it instead of download_bytes, and `source` says where and at which profile it was measured.",
+ "notes": "Curated download catalog. Sizes are bytes observed in real engine stores/caches (size_source=catalog) or null (unknown). verified=true means the artifact id was seen on a real engine or cache when the seed was built; other ids follow each engine's naming convention and are checked by presence probes and by the post-download verification in model_materializer. upstream={method, checked, revision?} records an id verified to exist upstream on that date (hf_api: HfApi.model_info(files_metadata=True), download_bytes = the weight files; ollama_registry: the registry manifest, download_bytes = the sum of its layers); such an artifact must carry its verified size. options carries route options the recommendation copies (the MTP builds: speculation). resident={bytes, source} (optional, per artifact) is the MEASURED memory the engine needs while it runs, for models whose working memory is not their file size (video generation): the fit verdict uses it instead of download_bytes, and `source` says where and at which profile it was measured. route={key, provider, model} (optional, per artifact) names the capability route that runs the artifact when its engine is not the download provider (AbstractVoice's faster-whisper runs `base`, fetched as a Hugging Face repo): what a surface shows and writes for that route, and how a route stored with the download pair is repaired (capability_defaults.repair_download_pair_routes).",
  "companion_sizes": {
   "mlx-community/Qwen3.5-4B-MTP-4bit": {
    "download_bytes": 67859512,
@@ -4345,6 +4345,11 @@
      "download_bytes": 147886409,
      "size_source": "catalog",
      "verified": true,
+     "route": {
+      "key": "input.voice",
+      "provider": "faster-whisper",
+      "model": "base"
+     },
      "upstream": {
       "method": "hf_api",
       "checked": "2026-09-28",
@@ -4381,6 +4386,11 @@
      "download_bytes": 11105348328,
      "size_source": "catalog",
      "verified": true,
+     "route": {
+      "key": "output.music",
+      "provider": "acestep",
+      "model": "ACE-Step/acestep-v15-xl-turbo-diffusers"
+     },
      "upstream": {
       "method": "hf_api",
       "checked": "2026-09-28",

{abstractcore-2.20.2 → abstractcore-2.22.0}/abstractcore/assets/model_downloads_catalog.schema.json

@@ -95,6 +95,17 @@
           "properties": {"speculation": {}},
           "additionalProperties": false
         },
+        "route": {
+          "type": "object",
+          "description": "The capability route that runs this artifact when its engine is not the download provider (AbstractVoice's faster-whisper runs `base`, fetched from a Hugging Face repo): what a surface shows and writes for that route, and the target of the repair of a route stored with the download pair.",
+          "required": ["key", "provider", "model"],
+          "properties": {
+            "key": {"type": "string", "minLength": 1},
+            "provider": {"type": "string", "minLength": 1},
+            "model": {"type": "string", "minLength": 1}
+          },
+          "additionalProperties": false
+        },
         "note": {"type": "string", "minLength": 1},
         "upstream": {"$ref": "#/$defs/upstream"},
         "resident": {

{abstractcore-2.20.2 → abstractcore-2.22.0}/abstractcore/comms/email/__init__.py

@@ -20,7 +20,9 @@ Modules: `models` (typed settings), `client` (IMAP read-only + SMTP, verified TL
 `bodystructure` (the MIME structure used to fetch only the parts needed),
 `policy` (recipient allowlist / denylist), `limits` (send rate limits), `vault` (encrypted
 credentials), `oauth` (OAuth2 / XOAUTH2), `store` (settings + secret + status), `context`
-(the guarded send), `errors` (typed errors), `legacy` (one-time import of pre-2.20 settings).
+(the guarded send), `errors` (typed errors), `legacy` (one-time import of pre-2.20 settings),
+`discovery` (a mailbox's IMAP/SMTP servers from its address: known providers, autoconfig, ISPDB,
+DNS SRV, MX).
 """
 
 from .client import DEFAULT_MAX_MESSAGE_BYTES, MAX_LIST_LIMIT, EmailClient, auto_submitted_value, tls_context
@@ -52,6 +54,7 @@ from .errors import (
     EmailTransient,
     EmailUnreachable,
 )
+from .discovery import EmailDiscoveryFailed, discover_servers, require_servers, server_defaults
 from .limits import SendRateLimiter
 from .models import (
     AUTO_SUBMITTED_GENERATED,
@@ -83,6 +86,7 @@ from .oauth import (
     OAuthTokenProvider,
     TokenSet,
     builtin_client,
+    oauth_providers_public,
     provider_preset,
     resolve_oauth_client,
     xoauth2_string,
@@ -115,6 +119,7 @@ __all__ = [
     "EmailClient",
     "EmailContext",
     "EmailDisabled",
+    "EmailDiscoveryFailed",
     "EmailError",
     "EmailInvalidMessage",
     "EmailInvalidSettings",
@@ -158,6 +163,10 @@ __all__ = [
     "SmtpSettings",
     "TokenSet",
     "builtin_client",
+    "discover_servers",
+    "oauth_providers_public",
+    "require_servers",
+    "server_defaults",
     "evaluate",
     "guarded_send",
     "normalize_address",