autotouch-cli 0.2.45__tar.gz → 0.2.46__tar.gz

{autotouch_cli-0.2.45/autotouch_cli.egg-info → autotouch_cli-0.2.46}/PKG-INFO

@@ -1,11 +1,27 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.45
+Version: 0.2.46
 Summary: Autotouch Smart Table CLI
+Project-URL: Homepage, https://app.autotouch.ai
+Project-URL: Documentation, https://github.com/nicolonic/autotouch_main/tree/main/docs/research-table/reference
+Project-URL: Source, https://github.com/nicolonic/autotouch_main
+Keywords: autotouch,smart-table,cli,automation,api
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: requests>=2.31.0
 Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: mongo
+Requires-Dist: pymongo>=4.7; extra == "mongo"
 
 # Autotouch CLI
 
@@ -31,13 +47,15 @@ pip install autotouch-cli
 Existing developer key:
 
 ```bash
-autotouch setup --api-key stk_... --base-url https://app.autotouch.ai
+read -s AUTOTOUCH_API_KEY
+export AUTOTOUCH_API_KEY
+autotouch setup --api-key "$AUTOTOUCH_API_KEY" --base-url https://app.autotouch.ai
 ```
 
 Equivalent manual steps:
 
 ```bash
-autotouch auth set-key --api-key stk_... --base-url https://app.autotouch.ai
+autotouch auth set-key --api-key "$AUTOTOUCH_API_KEY" --base-url https://app.autotouch.ai
 autotouch auth check --base-url https://app.autotouch.ai
 ```
 
@@ -45,23 +63,31 @@ Fresh account:
 
 ```bash
 export AUTOTOUCH_CONFIG_PATH=/tmp/autotouch-audit.json
+read -s AUTOTOUCH_BOOTSTRAP_PASSWORD
+export AUTOTOUCH_BOOTSTRAP_PASSWORD
 
 autotouch auth bootstrap \
   --first-name Ada \
   --last-name Lovelace \
   --email ada+audit@example.com \
-  --password 'use-a-strong-random-password' \
+  --password "$AUTOTOUCH_BOOTSTRAP_PASSWORD" \
   --organization-name "Audit Org" \
   --save-key
 
 autotouch auth check
 ```
 
+Config precedence:
+- Explicit flags win over environment variables.
+- Environment variables win over saved config.
+- Saved config wins over built-in defaults.
+- For JSON payload inputs, pass either `--data-json` or `--data-file`, not both.
+
 ## 5-Minute Flow
 
 ```bash
 # 0) First-run setup
-autotouch setup --api-key stk_... --base-url https://app.autotouch.ai
+autotouch setup --api-key "$AUTOTOUCH_API_KEY" --base-url https://app.autotouch.ai
 
 # 1) Inspect machine-readable contract
 autotouch capabilities --output json
@@ -85,7 +111,7 @@ COLUMN_ID=$(autotouch columns create --table-id "$TABLE_ID" --data-file column.j
 JOB_ID=$(autotouch columns run-next \
   --table-id "$TABLE_ID" \
   --column-id "$COLUMN_ID" \
-  --count 10 \
+  --count 2 \
   --show-estimate \
   --wait \
   --output json --select job_id)
@@ -118,10 +144,11 @@ For automation or agent-driven setup, use:
 - `autotouch capabilities --output json` for provider/workflow contracts
 - `autotouch rows list` / `autotouch rows get` / `autotouch cells get` for read-back and audit
 - `autotouch sequences ...` and `autotouch tasks ...` for sequence/task workflows
+- `pip install 'autotouch-cli[mongo]'` if you need the Mongo-backed `status` / `watch` commands
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.45/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.45/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.45/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.45/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.46/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.46/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.46/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.46/docs/platform/authentication.md

autotouch_cli-0.2.45/PKG-INFO → autotouch_cli-0.2.46/README.md

@@ -1,12 +1,3 @@
-Metadata-Version: 2.4
-Name: autotouch-cli
-Version: 0.2.45
-Summary: Autotouch Smart Table CLI
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: requests>=2.31.0
-Requires-Dist: python-dotenv>=1.0.0
-
 # Autotouch CLI
 
 Installable CLI for the Smart Table developer API.
@@ -31,13 +22,15 @@ pip install autotouch-cli
 Existing developer key:
 
 ```bash
-autotouch setup --api-key stk_... --base-url https://app.autotouch.ai
+read -s AUTOTOUCH_API_KEY
+export AUTOTOUCH_API_KEY
+autotouch setup --api-key "$AUTOTOUCH_API_KEY" --base-url https://app.autotouch.ai
 ```
 
 Equivalent manual steps:
 
 ```bash
-autotouch auth set-key --api-key stk_... --base-url https://app.autotouch.ai
+autotouch auth set-key --api-key "$AUTOTOUCH_API_KEY" --base-url https://app.autotouch.ai
 autotouch auth check --base-url https://app.autotouch.ai
 ```
 
@@ -45,23 +38,31 @@ Fresh account:
 
 ```bash
 export AUTOTOUCH_CONFIG_PATH=/tmp/autotouch-audit.json
+read -s AUTOTOUCH_BOOTSTRAP_PASSWORD
+export AUTOTOUCH_BOOTSTRAP_PASSWORD
 
 autotouch auth bootstrap \
   --first-name Ada \
   --last-name Lovelace \
   --email ada+audit@example.com \
-  --password 'use-a-strong-random-password' \
+  --password "$AUTOTOUCH_BOOTSTRAP_PASSWORD" \
   --organization-name "Audit Org" \
   --save-key
 
 autotouch auth check
 ```
 
+Config precedence:
+- Explicit flags win over environment variables.
+- Environment variables win over saved config.
+- Saved config wins over built-in defaults.
+- For JSON payload inputs, pass either `--data-json` or `--data-file`, not both.
+
 ## 5-Minute Flow
 
 ```bash
 # 0) First-run setup
-autotouch setup --api-key stk_... --base-url https://app.autotouch.ai
+autotouch setup --api-key "$AUTOTOUCH_API_KEY" --base-url https://app.autotouch.ai
 
 # 1) Inspect machine-readable contract
 autotouch capabilities --output json
@@ -85,7 +86,7 @@ COLUMN_ID=$(autotouch columns create --table-id "$TABLE_ID" --data-file column.j
 JOB_ID=$(autotouch columns run-next \
   --table-id "$TABLE_ID" \
   --column-id "$COLUMN_ID" \
-  --count 10 \
+  --count 2 \
   --show-estimate \
   --wait \
   --output json --select job_id)
@@ -118,10 +119,11 @@ For automation or agent-driven setup, use:
 - `autotouch capabilities --output json` for provider/workflow contracts
 - `autotouch rows list` / `autotouch rows get` / `autotouch cells get` for read-back and audit
 - `autotouch sequences ...` and `autotouch tasks ...` for sequence/task workflows
+- `pip install 'autotouch-cli[mongo]'` if you need the Mongo-backed `status` / `watch` commands
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.45/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.45/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.45/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.45/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.46/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.46/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.46/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.46/docs/platform/authentication.md

{autotouch_cli-0.2.45 → autotouch_cli-0.2.46}/autotouch_cli/cli.py

@@ -4218,7 +4218,7 @@ def build_parser() -> argparse.ArgumentParser:
     palias_run_next = sub.add_parser("run-next", help="Alias for: columns run-next")
     palias_run_next.add_argument("--table-id", required=True)
     palias_run_next.add_argument("--column-id", required=True)
-    palias_run_next.add_argument("--count", type=int, required=True, help="Exact number of rows to queue")
+    palias_run_next.add_argument("--count", type=int, required=True, help="Maximum number of rows to queue")
     palias_run_next.add_argument("--filters-json", help="Optional JSON object to select from filtered rows")
     palias_run_next.add_argument("--filters-file", help="Optional JSON file to select from filtered rows")
     palias_run_next.add_argument("--page-size", type=int, default=200, help="Rows page size while selecting candidates (max 1000)")

{autotouch_cli-0.2.45 → autotouch_cli-0.2.46}/autotouch_cli/cli_contracts.py

@@ -1,9 +1,13 @@
 from __future__ import annotations
 
 import argparse
+import json
 from typing import Any, Dict, List, Optional, Tuple
 
 
+_CLI_MANIFEST_SCHEMA_VERSION = 2
+
+
 _AUTH_MODE_EXACT: Dict[str, str] = {
     "setup": "none",
     "auth.bootstrap": "none",
@@ -79,6 +83,80 @@ _OPTIONAL_DEPENDENCY_COMMANDS: Dict[str, Dict[str, Any]] = {
     },
 }
 
+_SENSITIVE_OPTION_TERMS = ("token", "api-key", "api_key", "password", "secret")
+
+
+def _json_safe_value(value: Any) -> Any:
+    try:
+        json.dumps(value)
+    except (TypeError, ValueError):
+        return str(value)
+    return value
+
+
+def _option_input_kind(action: argparse.Action) -> Optional[str]:
+    flags = [flag.lower() for flag in getattr(action, "option_strings", []) or []]
+    dest = str(getattr(action, "dest", "") or "").lower()
+    if any(flag.endswith("-file") or flag == "--file" for flag in flags) or dest.endswith("_file"):
+        return "file"
+    if any(flag.endswith("-json") for flag in flags) or dest.endswith("_json"):
+        return "json"
+    if dest in {"out_file", "checkpoint_file"}:
+        return "file"
+    return None
+
+
+def _option_kind(action: argparse.Action, *, input_kind: Optional[str]) -> str:
+    if isinstance(action, (argparse._StoreTrueAction, argparse._StoreFalseAction)):
+        return "boolean"
+    if isinstance(action, argparse._CountAction):
+        return "integer"
+    if input_kind:
+        return input_kind
+    if getattr(action, "type", None) is int:
+        return "integer"
+    if getattr(action, "type", None) is float:
+        return "number"
+    if getattr(action, "nargs", None) in ("*", "+"):
+        return "list"
+    return "string"
+
+
+def _option_action_kind(action: argparse.Action) -> str:
+    if isinstance(action, argparse._StoreTrueAction):
+        return "store_true"
+    if isinstance(action, argparse._StoreFalseAction):
+        return "store_false"
+    if isinstance(action, argparse._AppendAction):
+        return "append"
+    if isinstance(action, argparse._AppendConstAction):
+        return "append_const"
+    if isinstance(action, argparse._CountAction):
+        return "count"
+    if isinstance(action, argparse._StoreConstAction):
+        return "store_const"
+    return "store"
+
+
+def _option_is_sensitive(action: argparse.Action) -> bool:
+    option_strings = [flag.lower() for flag in getattr(action, "option_strings", []) or []]
+    dest = str(getattr(action, "dest", "") or "").lower()
+    if isinstance(action, (argparse._StoreTrueAction, argparse._StoreFalseAction, argparse._StoreConstAction, argparse._AppendConstAction)):
+        return False
+    if dest == "value" or "--value" in option_strings:
+        return True
+    searchable = " ".join([dest, *option_strings])
+    return any(term in searchable for term in _SENSITIVE_OPTION_TERMS)
+
+
+def _option_accepts_comma_separated(action: argparse.Action) -> bool:
+    help_text = str(getattr(action, "help", "") or "").lower()
+    return "comma-separated" in help_text
+
+
+def _option_repeatable(action: argparse.Action) -> bool:
+    return isinstance(action, (argparse._AppendAction, argparse._AppendConstAction, argparse._CountAction))
+
 
 def canonical_subparser_entries(
     action: argparse._SubParsersAction,
@@ -123,10 +201,14 @@ def action_descriptor(action: argparse.Action) -> Optional[Dict[str, Any]]:
     if isinstance(action, argparse._SubParsersAction):
         return None
 
+    input_kind = _option_input_kind(action)
+    action_kind = _option_action_kind(action)
     payload: Dict[str, Any] = {
         "dest": action.dest,
         "required": bool(getattr(action, "required", False)),
         "help": action.help,
+        "kind": _option_kind(action, input_kind=input_kind),
+        "action": action_kind,
     }
     if getattr(action, "choices", None) is not None:
         payload["choices"] = list(action.choices)
@@ -135,11 +217,29 @@ def action_descriptor(action: argparse.Action) -> Optional[Dict[str, Any]]:
     if getattr(action, "metavar", None) is not None:
         payload["metavar"] = action.metavar
     default_value = getattr(action, "default", argparse.SUPPRESS)
-    if default_value is not argparse.SUPPRESS and default_value is not None:
-        payload["default"] = default_value
+    if default_value is not argparse.SUPPRESS:
+        if default_value is not None or isinstance(action, (argparse._StoreTrueAction, argparse._StoreFalseAction)):
+            payload["default_when_omitted"] = _json_safe_value(default_value)
+        if default_value is not None and not isinstance(action, (argparse._StoreTrueAction, argparse._StoreFalseAction)):
+            payload["default"] = _json_safe_value(default_value)
+    if isinstance(action, argparse._StoreTrueAction):
+        payload["value_when_present"] = True
+    elif isinstance(action, argparse._StoreFalseAction):
+        payload["value_when_present"] = False
+    if input_kind:
+        payload["input_kind"] = input_kind
+    if _option_repeatable(action):
+        payload["repeatable"] = True
+    if _option_accepts_comma_separated(action):
+        payload["accepts_comma_separated"] = True
+    if _option_is_sensitive(action):
+        payload["sensitive"] = True
     if action.option_strings:
         payload["flags"] = list(action.option_strings)
-        payload["takes_value"] = getattr(action, "nargs", None) != 0
+        payload["takes_value"] = not isinstance(
+            action,
+            (argparse._StoreTrueAction, argparse._StoreFalseAction, argparse._StoreConstAction, argparse._AppendConstAction),
+        ) and getattr(action, "nargs", None) != 0
     else:
         payload["name"] = action.dest
         payload["positional"] = True
@@ -301,6 +401,7 @@ def collect_cli_command_manifest(
 def build_cli_manifest(version: str, parser: argparse.ArgumentParser) -> Dict[str, Any]:
     return {
         "version": version,
+        "manifest_schema_version": _CLI_MANIFEST_SCHEMA_VERSION,
         "entry_points": {
             "autotouch": "autotouch_cli.cli:main",
             "smart-table": "autotouch_cli.cli:main",
@@ -311,11 +412,13 @@ def build_cli_manifest(version: str, parser: argparse.ArgumentParser) -> Dict[st
 
 def build_cli_reference_markdown(manifest: Dict[str, Any]) -> str:
     version = str(manifest.get("version") or "unknown")
+    manifest_schema_version = str(manifest.get("manifest_schema_version") or "unknown")
     commands = manifest.get("commands") if isinstance(manifest.get("commands"), dict) else {}
     lines: List[str] = [
         "# Autotouch CLI Reference",
         "",
         f"Generated from the installed parser for `autotouch-cli` `{version}`.",
+        f"Manifest schema version: `{manifest_schema_version}`.",
         "",
         "## Output Modes",
         "",
@@ -394,9 +497,23 @@ def build_cli_reference_markdown(manifest: Dict[str, Any]) -> str:
                     note_parts: List[str] = []
                     if option.get("required"):
                         note_parts.append("required")
+                    if option.get("kind"):
+                        note_parts.append(f"kind={option.get('kind')}")
+                    if option.get("input_kind"):
+                        note_parts.append(f"input={option.get('input_kind')}")
+                    if option.get("repeatable"):
+                        note_parts.append("repeatable")
+                    if option.get("accepts_comma_separated"):
+                        note_parts.append("comma-separated")
+                    if option.get("sensitive"):
+                        note_parts.append("sensitive")
+                    if option.get("action") in {"store_true", "store_false"}:
+                        note_parts.append(
+                            f"when omitted={option.get('default_when_omitted')}; when present={option.get('value_when_present')}"
+                        )
                     if option.get("choices"):
                         note_parts.append(f"choices={','.join(str(v) for v in option.get('choices') or [])}")
-                    if option.get("default") is not None:
+                    if option.get("default") is not None and option.get("action") not in {"store_true", "store_false"}:
                         note_parts.append(f"default={option.get('default')}")
                     help_value = str(option.get("help") or "").strip()
                     note_text = f" ({'; '.join(note_parts)})" if note_parts else ""

{autotouch_cli-0.2.45 → autotouch_cli-0.2.46}/autotouch_cli/commands/columns.py

@@ -415,10 +415,10 @@ def register_columns_subcommands(
     add_api_common_arguments(pcs)
     pcs.set_defaults(func=handlers["stop"])
 
-    pcrn = col_sub.add_parser("run-next", help="Run exactly N selected rows using subset scope")
+    pcrn = col_sub.add_parser("run-next", help="Run up to N selected rows using subset scope")
     pcrn.add_argument("--table-id", required=True)
     pcrn.add_argument("--column-id", required=True)
-    pcrn.add_argument("--count", type=int, required=True, help="Exact number of rows to queue")
+    pcrn.add_argument("--count", type=int, required=True, help="Maximum number of rows to queue")
     pcrn.add_argument("--filters-json", help="Optional JSON object to select from filtered rows")
     pcrn.add_argument("--filters-file", help="Optional JSON file to select from filtered rows")
     pcrn.add_argument("--page-size", type=int, default=200, help="Rows page size while selecting candidates (max 1000)")

{autotouch_cli-0.2.45 → autotouch_cli-0.2.46}/autotouch_cli/core/auth.py

@@ -68,8 +68,9 @@ def print_missing_developer_auth_help() -> None:
     print(
         "Fresh-account / isolated audit pattern: "
         "`export AUTOTOUCH_CONFIG_PATH=/tmp/autotouch-audit.json && "
+        "read -s AUTOTOUCH_BOOTSTRAP_PASSWORD && export AUTOTOUCH_BOOTSTRAP_PASSWORD && "
         "autotouch auth bootstrap --first-name Ada --last-name Lovelace "
-        "--email ada+audit@example.com --password 'use-a-strong-random-password' "
+        "--email ada+audit@example.com --password \"$AUTOTOUCH_BOOTSTRAP_PASSWORD\" "
         "--organization-name \"Audit Org\" --save-key`",
         file=sys.stderr,
     )
@@ -89,8 +90,9 @@ def print_missing_user_session_help() -> None:
     print(
         "Fresh-account / isolated audit pattern: "
         "`export AUTOTOUCH_CONFIG_PATH=/tmp/autotouch-audit.json && "
+        "read -s AUTOTOUCH_BOOTSTRAP_PASSWORD && export AUTOTOUCH_BOOTSTRAP_PASSWORD && "
         "autotouch auth bootstrap --first-name Ada --last-name Lovelace "
-        "--email ada+audit@example.com --password 'use-a-strong-random-password' "
+        "--email ada+audit@example.com --password \"$AUTOTOUCH_BOOTSTRAP_PASSWORD\" "
         "--organization-name \"Audit Org\" --save-key`",
         file=sys.stderr,
     )
@@ -157,4 +159,3 @@ def auth_headers(token: Optional[str], *, use_x_api_key: bool = False) -> Dict[s
     if use_x_api_key:
         return {"X-API-Key": token}
     return {"Authorization": f"Bearer {token}"}
-