cat-stack 2.5.2__tar.gz → 2.5.3__tar.gz

{cat_stack-2.5.2 → cat_stack-2.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cat-stack
-Version: 2.5.2
+Version: 2.5.3
 Summary: Domain-agnostic text, image, PDF, and DOCX classification engine powered by LLMs
 Project-URL: Documentation, https://github.com/chrissoria/cat-stack#readme
 Project-URL: Issues, https://github.com/chrissoria/cat-stack/issues
@@ -24,9 +24,9 @@ Requires-Dist: pandas
 Requires-Dist: requests
 Requires-Dist: tqdm
 Provides-Extra: agent
-Requires-Dist: cat-claws[claude]>=0.3.2; extra == 'agent'
+Requires-Dist: cat-claws[claude]>=0.3.3; extra == 'agent'
 Provides-Extra: codex-agent
-Requires-Dist: cat-claws[codex]>=0.3.2; extra == 'codex-agent'
+Requires-Dist: cat-claws[codex]>=0.3.3; extra == 'codex-agent'
 Provides-Extra: docx
 Requires-Dist: python-docx>=1.0.0; extra == 'docx'
 Provides-Extra: embeddings
@@ -239,7 +239,7 @@ OpenAI, Anthropic, Google (Gemini), Mistral, Perplexity, xAI (Grok), HuggingFace
 
 All providers use the same `(model_name, provider, api_key)` tuple format. Provider is auto-detected from model name if omitted.
 
-**Subscription backends (no API key).** Three `model_source` values authenticate through a chat subscription instead of a metered key — leave `api_key` unset: `"claude-agent"` (Claude subscription via the Agent SDK; `pip install "cat-stack[agent]"`), `"claude-code"` (the Claude Code CLI, if installed — no extra needed), and `"codex-agent"` (ChatGPT subscription; `pip install "cat-stack[codex-agent]"`). Classification, extraction, exploration, and summarization all route through them.
+**Subscription backends (no API key).** Three `model_source` values authenticate through a chat subscription instead of a metered key — leave `api_key` unset: `"claude-agent"` (Claude subscription via the Agent SDK; `pip install "cat-stack[agent]"`), `"claude-code"` (the Claude Code CLI, if installed — no extra needed), and `"codex-agent"` (ChatGPT subscription; `pip install "cat-stack[codex-agent]"`). Classification, extraction, exploration, and summarization all route through them, including images and PDF pages on the two agent backends. They use the agent CLI's own sign-in (separate from the Claude desktop app's): runs check it up front and, if you're signed out, open a single browser window to sign in once, then continue. See the [cat-claws README](https://github.com/chrissoria/cat-agent#signing-in-once).
 
 **Reproducibility note:** the same nominal model can behave differently across access routes. In a seed-matched benchmark (Claude Sonnet 5, temperature 0), extraction through the Agent SDK produced more varied label phrasings than the direct API (89% vs. 74% unique raw labels), while final consolidated taxonomies were equivalent. If raw label counts matter to your analysis, record the access route alongside the model version.
 

{cat_stack-2.5.2 → cat_stack-2.5.3}/README.md

@@ -198,7 +198,7 @@ OpenAI, Anthropic, Google (Gemini), Mistral, Perplexity, xAI (Grok), HuggingFace
 
 All providers use the same `(model_name, provider, api_key)` tuple format. Provider is auto-detected from model name if omitted.
 
-**Subscription backends (no API key).** Three `model_source` values authenticate through a chat subscription instead of a metered key — leave `api_key` unset: `"claude-agent"` (Claude subscription via the Agent SDK; `pip install "cat-stack[agent]"`), `"claude-code"` (the Claude Code CLI, if installed — no extra needed), and `"codex-agent"` (ChatGPT subscription; `pip install "cat-stack[codex-agent]"`). Classification, extraction, exploration, and summarization all route through them.
+**Subscription backends (no API key).** Three `model_source` values authenticate through a chat subscription instead of a metered key — leave `api_key` unset: `"claude-agent"` (Claude subscription via the Agent SDK; `pip install "cat-stack[agent]"`), `"claude-code"` (the Claude Code CLI, if installed — no extra needed), and `"codex-agent"` (ChatGPT subscription; `pip install "cat-stack[codex-agent]"`). Classification, extraction, exploration, and summarization all route through them, including images and PDF pages on the two agent backends. They use the agent CLI's own sign-in (separate from the Claude desktop app's): runs check it up front and, if you're signed out, open a single browser window to sign in once, then continue. See the [cat-claws README](https://github.com/chrissoria/cat-agent#signing-in-once).
 
 **Reproducibility note:** the same nominal model can behave differently across access routes. In a seed-matched benchmark (Claude Sonnet 5, temperature 0), extraction through the Agent SDK produced more varied label phrasings than the direct API (89% vs. 74% unique raw labels), while final consolidated taxonomies were equivalent. If raw label counts matter to your analysis, record the access route alongside the model version.
 

{cat_stack-2.5.2 → cat_stack-2.5.3}/pyproject.toml

@@ -42,8 +42,8 @@ embeddings = ["sentence-transformers>=2.2.0"]
 # `agent` keeps its historical meaning (the Claude backend) so every shipped
 # install hint stays true; `codex-agent` matches the provider string so the
 # error-message hint is copy-pasteable.
-agent = ["cat-claws[claude]>=0.3.2"]
-codex-agent = ["cat-claws[codex]>=0.3.2"]
+agent = ["cat-claws[claude]>=0.3.3"]
+codex-agent = ["cat-claws[codex]>=0.3.3"]
 
 [project.urls]
 Documentation = "https://github.com/chrissoria/cat-stack#readme"

{cat_stack-2.5.2 → cat_stack-2.5.3}/src/catstack/__about__.py

@@ -1,7 +1,7 @@
 # SPDX-FileCopyrightText: 2025-present Christopher Soria <chrissoria@berkeley.edu>
 #
 # SPDX-License-Identifier: GPL-3.0-or-later
-__version__ = "2.5.2"
+__version__ = "2.5.3"
 __author__ = "Chris Soria"
 __email__ = "chrissoria@berkeley.edu"
 __title__ = "cat-stack"

{cat_stack-2.5.2 → cat_stack-2.5.3}/src/catstack/_providers.py

@@ -790,6 +790,24 @@ def _split_agent_content(content):
     return "\n\n".join(t for t in texts if t), images
 
 
+def _require_agent_sign_in(provider):
+    """Preflight for the cat-claws subscription backends: stop before any row
+    runs when the agent CLI is signed out, instead of every row failing on
+    "not logged in". cat-claws >= 0.3.3 checks with a cheap status call (no
+    model call); if signed out it opens ONE browser sign-in automatically and
+    continues, or, where no browser can open, raises NotSignedInError with
+    instructions worded for the Claude app or a terminal. No-op for other
+    providers, and when cat-claws is missing or older.
+    """
+    if provider not in _AGENT_BACKENDS:
+        return
+    try:
+        from catclaws import ensure_signed_in
+    except ImportError:
+        return
+    ensure_signed_in(_AGENT_BACKENDS[provider][0])
+
+
 def _require_http_provider(model_source, feature):
     """Raise a clear error when an HTTP-only feature is used with a
     subscription/CLI provider (claude-code / claude-agent / codex-agent)."""

{cat_stack-2.5.2 → cat_stack-2.5.3}/src/catstack/image_functions.py

@@ -154,6 +154,8 @@ def image_multi_class(
             "(the text-only CLI shim). Use model_source='claude-agent' (the cat-claws "
             "subscription backend) or an API-key provider."
         )
+    from ._providers import _require_agent_sign_in
+    _require_agent_sign_in(model_source)
 
     image_files = _load_image_files(image_input)
 

{cat_stack-2.5.2 → cat_stack-2.5.3}/src/catstack/pdf_functions.py

@@ -399,6 +399,8 @@ def pdf_multi_class(
             "(the text-only CLI shim). Use model_source='claude-agent' (the cat-claws "
             "subscription backend) or an API-key provider."
         )
+    from ._providers import _require_agent_sign_in
+    _require_agent_sign_in(model_source)
 
     # Providers with native PDF support (only used in image/both modes)
     native_pdf_providers = {"anthropic", "google"}

{cat_stack-2.5.2 → cat_stack-2.5.3}/src/catstack/text_functions_ensemble.py

@@ -53,6 +53,7 @@ from concurrent.futures import ThreadPoolExecutor, as_completed
 from typing import Optional, Callable, Union
 
 from ._utils import _extract_balanced_json
+from ._providers import _require_agent_sign_in
 from .text_functions import (
     UnifiedLLMClient,
     detect_provider,
@@ -684,6 +685,7 @@ def prepare_model_configs(
                     "Install: pip install cat-stack[agent]\n"
                     + "="*60
                 )
+            _require_agent_sign_in(detected_provider)
         elif detected_provider == "codex-agent":
             try:
                 import catclaws  # noqa: F401
@@ -696,6 +698,7 @@ def prepare_model_configs(
                     'Install: pip install "cat-stack[codex-agent]"\n'
                     + "="*60
                 )
+            _require_agent_sign_in(detected_provider)
         else:
             # Validate API key exists for cloud providers
             if not api_key: