autotouch-cli 0.2.48__tar.gz → 0.2.50__tar.gz

{autotouch_cli-0.2.48 → autotouch_cli-0.2.50}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.48
+Version: 0.2.50
 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
@@ -157,7 +157,7 @@ Only send `user_schema` / `response_schema` when you intentionally want to overr
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/platform/authentication.md

{autotouch_cli-0.2.48 → autotouch_cli-0.2.50}/README.md

@@ -132,7 +132,7 @@ Only send `user_schema` / `response_schema` when you intentionally want to overr
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/platform/authentication.md

{autotouch_cli-0.2.48 → autotouch_cli-0.2.50}/autotouch_cli/cli.py

@@ -45,6 +45,7 @@ from autotouch_cli.commands.columns import (
     cmd_columns_delete as cmd_columns_delete_impl,
     cmd_columns_estimate as cmd_columns_estimate_impl,
     cmd_columns_list as cmd_columns_list_impl,
+    cmd_columns_move as cmd_columns_move_impl,
     cmd_columns_projections as cmd_columns_projections_impl,
     cmd_columns_run as cmd_columns_run_impl,
     cmd_columns_run_next as cmd_columns_run_next_impl,
@@ -3282,6 +3283,10 @@ def cmd_columns_update(args: argparse.Namespace) -> None:
     cmd_columns_update_impl(args, runtime=_column_command_runtime())
 
 
+def cmd_columns_move(args: argparse.Namespace) -> None:
+    cmd_columns_move_impl(args, runtime=_column_command_runtime())
+
+
 def cmd_columns_delete(args: argparse.Namespace) -> None:
     cmd_columns_delete_impl(args, runtime=_column_command_runtime())
 
@@ -4077,6 +4082,7 @@ def build_parser() -> argparse.ArgumentParser:
             "list": cmd_columns_list,
             "create": cmd_columns_create,
             "update": cmd_columns_update,
+            "move": cmd_columns_move,
             "delete": cmd_columns_delete,
             "projections": cmd_columns_projections,
             "test_http_request": cmd_columns_test_http_request,

{autotouch_cli-0.2.48 → autotouch_cli-0.2.50}/autotouch_cli/commands/columns.py

@@ -22,6 +22,39 @@ class ColumnCommandRuntime:
     select_next_row_ids: Callable[..., Dict[str, Any]]
 
 
+def _validate_position_flags(args: argparse.Namespace, *, allow_position: bool) -> None:
+    if allow_position and getattr(args, "position", None) is not None:
+        if getattr(args, "after_column_id", None) or getattr(args, "before_column_id", None):
+            print(
+                "ERROR: --position cannot be combined with --after-column-id/--before-column-id",
+                file=sys.stderr,
+            )
+            sys.exit(2)
+
+
+def _apply_column_position_overrides(
+    payload: Dict[str, Any],
+    args: argparse.Namespace,
+    *,
+    allow_position: bool,
+    allow_neighbors: bool,
+) -> Dict[str, Any]:
+    merged = dict(payload)
+    _validate_position_flags(args, allow_position=allow_position)
+    if allow_position and getattr(args, "position", None) is not None:
+        merged["position"] = float(args.position)
+        merged.pop("afterColumnId", None)
+        merged.pop("after_column_id", None)
+        merged.pop("beforeColumnId", None)
+        merged.pop("before_column_id", None)
+    if allow_neighbors:
+        if getattr(args, "after_column_id", None):
+            merged["afterColumnId"] = args.after_column_id
+        if getattr(args, "before_column_id", None):
+            merged["beforeColumnId"] = args.before_column_id
+    return merged
+
+
 def _normalize_http_request_test_payload(payload: Dict[str, Any]) -> Dict[str, Any]:
     candidate = payload
     config = payload.get("config")
@@ -79,6 +112,12 @@ def cmd_columns_create(args: argparse.Namespace, *, runtime: ColumnCommandRuntim
     if not isinstance(payload, dict):
         print("ERROR: column create requires --data-json/--data-file with a JSON object", file=sys.stderr)
         sys.exit(2)
+    payload = _apply_column_position_overrides(
+        payload,
+        args,
+        allow_position=True,
+        allow_neighbors=True,
+    )
     runtime.validate_column_contract_payload_or_exit(payload)
     runtime.validate_add_to_crm_create_payload(payload)
     data = runtime.request_api(
@@ -119,6 +158,12 @@ def cmd_columns_update(args: argparse.Namespace, *, runtime: ColumnCommandRuntim
     if not isinstance(payload, dict):
         print("ERROR: column update requires --data-json/--data-file with a JSON object", file=sys.stderr)
         sys.exit(2)
+    payload = _apply_column_position_overrides(
+        payload,
+        args,
+        allow_position=True,
+        allow_neighbors=False,
+    )
     runtime.validate_column_contract_payload_or_exit(payload)
     data = runtime.request_api(
         "PATCH",
@@ -165,6 +210,12 @@ def cmd_columns_projections(args: argparse.Namespace, *, runtime: ColumnCommandR
     if not isinstance(payload, dict):
         print("ERROR: projection create requires --data-json/--data-file with a JSON object", file=sys.stderr)
         sys.exit(2)
+    payload = _apply_column_position_overrides(
+        payload,
+        args,
+        allow_position=False,
+        allow_neighbors=True,
+    )
 
     preflight_warnings = runtime.build_projection_preflight_warnings(
         table_id=args.table_id,
@@ -200,6 +251,29 @@ def cmd_columns_projections(args: argparse.Namespace, *, runtime: ColumnCommandR
     runtime.print_json(data, args.compact)
 
 
+def cmd_columns_move(args: argparse.Namespace, *, runtime: ColumnCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    if not args.after_column_id and not args.before_column_id:
+        print("ERROR: columns move requires --after-column-id and/or --before-column-id", file=sys.stderr)
+        sys.exit(2)
+    payload: Dict[str, Any] = {}
+    if args.after_column_id:
+        payload["after_column_id"] = args.after_column_id
+    if args.before_column_id:
+        payload["before_column_id"] = args.before_column_id
+    data = runtime.request_api(
+        "PATCH",
+        f"/api/tables/{args.table_id}/columns/{args.column_id}/position",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
 def cmd_columns_test_http_request(args: argparse.Namespace, *, runtime: ColumnCommandRuntime) -> None:
     token = runtime.resolve_token(args.token, required=True)
     payload = runtime.load_json_input(
@@ -326,6 +400,9 @@ def register_columns_subcommands(
     pcc.add_argument("--table-id", required=True)
     pcc.add_argument("--data-json", help="ColumnCreate payload JSON")
     pcc.add_argument("--data-file", help="ColumnCreate payload file path")
+    pcc.add_argument("--position", type=float, help="Explicit numeric position override")
+    pcc.add_argument("--after-column-id", help="Place the new column after this existing column id")
+    pcc.add_argument("--before-column-id", help="Place the new column before this existing column id")
     add_api_common_arguments(pcc)
     pcc.set_defaults(func=handlers["create"])
 
@@ -341,9 +418,25 @@ def register_columns_subcommands(
     pcu.add_argument("--column-id", required=True)
     pcu.add_argument("--data-json", help="ColumnUpdate payload JSON")
     pcu.add_argument("--data-file", help="ColumnUpdate payload file path")
+    pcu.add_argument("--position", type=float, help="Explicit numeric position override")
     add_api_common_arguments(pcu)
     pcu.set_defaults(func=handlers["update"])
 
+    pcm = col_sub.add_parser(
+        "move",
+        help="Reorder an existing column relative to neighbors",
+        description=(
+            "Move an existing column by supplying neighbor column ids. "
+            "Prefer sending both neighbors when possible for stable placement."
+        ),
+    )
+    pcm.add_argument("--table-id", required=True)
+    pcm.add_argument("--column-id", required=True)
+    pcm.add_argument("--after-column-id", help="Place the column after this existing column id")
+    pcm.add_argument("--before-column-id", help="Place the column before this existing column id")
+    add_api_common_arguments(pcm)
+    pcm.set_defaults(func=handlers["move"])
+
     pcd = col_sub.add_parser("delete", help="Delete a column and all of its cells")
     pcd.add_argument("--table-id", required=True)
     pcd.add_argument("--column-id", required=True)
@@ -379,6 +472,8 @@ def register_columns_subcommands(
     pcpj.add_argument("--table-id", required=True)
     pcpj.add_argument("--data-json", help="CreateProjectionsRequest payload JSON")
     pcpj.add_argument("--data-file", help="CreateProjectionsRequest payload file path")
+    pcpj.add_argument("--after-column-id", help="Place the new projection group after this existing column id")
+    pcpj.add_argument("--before-column-id", help="Place the new projection group before this existing column id")
     add_api_common_arguments(pcpj)
     pcpj.set_defaults(func=handlers["projections"])
 

{autotouch_cli-0.2.48 → autotouch_cli-0.2.50}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.48`.
+Generated from the installed parser for `autotouch-cli` `0.2.50`.
 Manifest schema version: `2`.
 
 ## Output Modes
@@ -614,10 +614,10 @@ Column operations
 - Auth: `varies_by_subcommand`
 - Stability: `stable`
 - Destructive: `no`
-- Subcommands: `list, create, update, delete, projections, test-http-request, run, stop, run-next, estimate, recipe`
+- Subcommands: `list, create, update, move, delete, projections, test-http-request, run, stop, run-next, estimate, recipe`
 - Example:
   - `autotouch columns [-h]
-                         {list,create,update,delete,projections,test-http-request,run,stop,run-next,estimate,recipe} ...`
+                         {list,create,update,move,delete,projections,test-http-request,run,stop,run-next,estimate,recipe} ...`
 
 #### `autotouch columns create`
 
@@ -631,9 +631,11 @@ Create a column
 - Example:
   - `autotouch columns create [-h] --table-id TABLE_ID
                                 [--data-json DATA_JSON]
-                                [--data-file DATA_FILE] [--base-url BASE_URL]
-                                [--token TOKEN] [--use-x-api-key]
-                                [--timeout TIMEOUT]
+                                [--data-file DATA_FILE] [--position POSITION]
+                                [--after-column-id AFTER_COLUMN_ID]
+                                [--before-column-id BEFORE_COLUMN_ID]
+                                [--base-url BASE_URL] [--token TOKEN]
+                                [--use-x-api-key] [--timeout TIMEOUT]
                                 [--output {json,ndjson,human}] [--compact]
                                 [--select SELECT |
                                 --json-pointer JSON_POINTER] [--verbose]`
@@ -641,6 +643,9 @@ Create a column
   - `--table-id` (required; kind=string)
   - `--data-json` (kind=json; input=json): ColumnCreate payload JSON
   - `--data-file` (kind=file; input=file): ColumnCreate payload file path
+  - `--position` (kind=number): Explicit numeric position override
+  - `--after-column-id` (kind=string): Place the new column after this existing column id
+  - `--before-column-id` (kind=string): Place the new column before this existing column id
   - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
   - `--token` (kind=string; sensitive): Developer API key / JWT token
   - `--use-x-api-key` (kind=boolean; when omitted=False; when present=True): Send token via X-API-Key header
@@ -757,6 +762,41 @@ List table columns
   - `--json-pointer` (kind=string): Extract a JSON pointer from the final result (for example: /id)
   - `--verbose` (kind=boolean; when omitted=False; when present=True): Print request metadata to stderr
 
+#### `autotouch columns move`
+
+Reorder an existing column relative to neighbors
+
+Move an existing column by supplying neighbor column ids. Prefer sending both neighbors when possible for stable placement.
+
+- Auth: `developer_key_or_user_session`
+- Stability: `stable`
+- Destructive: `no`
+- Required flags: `--table-id, --column-id`
+- Output modes: `json, ndjson, human`
+- Example:
+  - `autotouch columns move [-h] --table-id TABLE_ID --column-id COLUMN_ID
+                              [--after-column-id AFTER_COLUMN_ID]
+                              [--before-column-id BEFORE_COLUMN_ID]
+                              [--base-url BASE_URL] [--token TOKEN]
+                              [--use-x-api-key] [--timeout TIMEOUT]
+                              [--output {json,ndjson,human}] [--compact]
+                              [--select SELECT | --json-pointer JSON_POINTER]
+                              [--verbose]`
+- Options:
+  - `--table-id` (required; kind=string)
+  - `--column-id` (required; kind=string)
+  - `--after-column-id` (kind=string): Place the column after this existing column id
+  - `--before-column-id` (kind=string): Place the column before this existing column id
+  - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
+  - `--token` (kind=string; sensitive): Developer API key / JWT token
+  - `--use-x-api-key` (kind=boolean; when omitted=False; when present=True): Send token via X-API-Key header
+  - `--timeout` (kind=integer; default=30): HTTP timeout in seconds
+  - `--output` (kind=string; choices=json,ndjson,human; default=json): Output mode
+  - `--compact` (kind=boolean; when omitted=False; when present=True): Print compact JSON
+  - `--select` (kind=string): Extract a dotted field path from the final result (for example: id or items.0.id)
+  - `--json-pointer` (kind=string): Extract a JSON pointer from the final result (for example: /id)
+  - `--verbose` (kind=boolean; when omitted=False; when present=True): Print request metadata to stderr
+
 #### `autotouch columns projections`
 
 Create JSON projection columns
@@ -774,6 +814,8 @@ Do not use `autotouch columns create` with `kind: "projection"` and empty `confi
   - `autotouch columns projections [-h] --table-id TABLE_ID
                                      [--data-json DATA_JSON]
                                      [--data-file DATA_FILE]
+                                     [--after-column-id AFTER_COLUMN_ID]
+                                     [--before-column-id BEFORE_COLUMN_ID]
                                      [--base-url BASE_URL] [--token TOKEN]
                                      [--use-x-api-key] [--timeout TIMEOUT]
                                      [--output {json,ndjson,human}]
@@ -802,6 +844,8 @@ Each item must include `key`, `label`, `sourceColumnId`, and `path`.
   - `--table-id` (required; kind=string)
   - `--data-json` (kind=json; input=json): CreateProjectionsRequest payload JSON
   - `--data-file` (kind=file; input=file): CreateProjectionsRequest payload file path
+  - `--after-column-id` (kind=string): Place the new projection group after this existing column id
+  - `--before-column-id` (kind=string): Place the new projection group before this existing column id
   - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
   - `--token` (kind=string; sensitive): Developer API key / JWT token
   - `--use-x-api-key` (kind=boolean; when omitted=False; when present=True): Send token via X-API-Key header
@@ -1039,9 +1083,9 @@ Update a column definition. Nested config keys merge into the existing config, s
 - Example:
   - `autotouch columns update [-h] --table-id TABLE_ID --column-id COLUMN_ID
                                 [--data-json DATA_JSON]
-                                [--data-file DATA_FILE] [--base-url BASE_URL]
-                                [--token TOKEN] [--use-x-api-key]
-                                [--timeout TIMEOUT]
+                                [--data-file DATA_FILE] [--position POSITION]
+                                [--base-url BASE_URL] [--token TOKEN]
+                                [--use-x-api-key] [--timeout TIMEOUT]
                                 [--output {json,ndjson,human}] [--compact]
                                 [--select SELECT |
                                 --json-pointer JSON_POINTER] [--verbose]`
@@ -1050,6 +1094,7 @@ Update a column definition. Nested config keys merge into the existing config, s
   - `--column-id` (required; kind=string)
   - `--data-json` (kind=json; input=json): ColumnUpdate payload JSON
   - `--data-file` (kind=file; input=file): ColumnUpdate payload file path
+  - `--position` (kind=number): Explicit numeric position override
   - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
   - `--token` (kind=string; sensitive): Developer API key / JWT token
   - `--use-x-api-key` (kind=boolean; when omitted=False; when present=True): Send token via X-API-Key header

{autotouch_cli-0.2.48 → autotouch_cli-0.2.50}/autotouch_cli/data/cli-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.48",
+  "version": "0.2.50",
   "manifest_schema_version": 2,
   "entry_points": {
     "autotouch": "autotouch_cli.cli:main",
@@ -12980,6 +12980,7 @@
         "list",
         "create",
         "update",
+        "move",
         "delete",
         "projections",
         "test-http-request",
@@ -12995,7 +12996,7 @@
       "output_contract": null,
       "availability": null,
       "examples": [
-        "autotouch columns [-h]\n                         {list,create,update,delete,projections,test-http-request,run,stop,run-next,estimate,recipe} ..."
+        "autotouch columns [-h]\n                         {list,create,update,move,delete,projections,test-http-request,run,stop,run-next,estimate,recipe} ..."
       ],
       "stability": "stable",
       "handler": null
@@ -13236,6 +13237,39 @@
           ],
           "takes_value": true
         },
+        {
+          "dest": "position",
+          "required": false,
+          "help": "Explicit numeric position override",
+          "kind": "number",
+          "action": "store",
+          "flags": [
+            "--position"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "after_column_id",
+          "required": false,
+          "help": "Place the new column after this existing column id",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--after-column-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "before_column_id",
+          "required": false,
+          "help": "Place the new column before this existing column id",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--before-column-id"
+          ],
+          "takes_value": true
+        },
         {
           "dest": "base_url",
           "required": false,
@@ -13389,7 +13423,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch columns create [-h] --table-id TABLE_ID\n                                [--data-json DATA_JSON]\n                                [--data-file DATA_FILE] [--base-url BASE_URL]\n                                [--token TOKEN] [--use-x-api-key]\n                                [--timeout TIMEOUT]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER] [--verbose]"
+        "autotouch columns create [-h] --table-id TABLE_ID\n                                [--data-json DATA_JSON]\n                                [--data-file DATA_FILE] [--position POSITION]\n                                [--after-column-id AFTER_COLUMN_ID]\n                                [--before-column-id BEFORE_COLUMN_ID]\n                                [--base-url BASE_URL] [--token TOKEN]\n                                [--use-x-api-key] [--timeout TIMEOUT]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER] [--verbose]"
       ],
       "stability": "stable",
       "handler": "cmd_columns_create"
@@ -13457,6 +13491,17 @@
           ],
           "takes_value": true
         },
+        {
+          "dest": "position",
+          "required": false,
+          "help": "Explicit numeric position override",
+          "kind": "number",
+          "action": "store",
+          "flags": [
+            "--position"
+          ],
+          "takes_value": true
+        },
         {
           "dest": "base_url",
           "required": false,
@@ -13610,11 +13655,230 @@
       },
       "availability": null,
       "examples": [
-        "autotouch columns update [-h] --table-id TABLE_ID --column-id COLUMN_ID\n                                [--data-json DATA_JSON]\n                                [--data-file DATA_FILE] [--base-url BASE_URL]\n                                [--token TOKEN] [--use-x-api-key]\n                                [--timeout TIMEOUT]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER] [--verbose]"
+        "autotouch columns update [-h] --table-id TABLE_ID --column-id COLUMN_ID\n                                [--data-json DATA_JSON]\n                                [--data-file DATA_FILE] [--position POSITION]\n                                [--base-url BASE_URL] [--token TOKEN]\n                                [--use-x-api-key] [--timeout TIMEOUT]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER] [--verbose]"
       ],
       "stability": "stable",
       "handler": "cmd_columns_update"
     },
+    "columns.move": {
+      "canonical": [
+        "autotouch",
+        "columns",
+        "move"
+      ],
+      "aliases": [],
+      "group": "columns",
+      "help": "Reorder an existing column relative to neighbors",
+      "description": "Move an existing column by supplying neighbor column ids. Prefer sending both neighbors when possible for stable placement.",
+      "notes": null,
+      "required_flags": [
+        "--table-id",
+        "--column-id"
+      ],
+      "positionals": [],
+      "options": [
+        {
+          "dest": "table_id",
+          "required": true,
+          "help": null,
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--table-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "column_id",
+          "required": true,
+          "help": null,
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--column-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "after_column_id",
+          "required": false,
+          "help": "Place the column after this existing column id",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--after-column-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "before_column_id",
+          "required": false,
+          "help": "Place the column before this existing column id",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--before-column-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "base_url",
+          "required": false,
+          "help": "API base URL (default: https://app.autotouch.ai)",
+          "kind": "string",
+          "action": "store",
+          "default_when_omitted": "https://app.autotouch.ai",
+          "default": "https://app.autotouch.ai",
+          "flags": [
+            "--base-url"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "token",
+          "required": false,
+          "help": "Developer API key / JWT token",
+          "kind": "string",
+          "action": "store",
+          "sensitive": true,
+          "flags": [
+            "--token"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "use_x_api_key",
+          "required": false,
+          "help": "Send token via X-API-Key header",
+          "kind": "boolean",
+          "action": "store_true",
+          "nargs": 0,
+          "default_when_omitted": false,
+          "value_when_present": true,
+          "flags": [
+            "--use-x-api-key"
+          ],
+          "takes_value": false
+        },
+        {
+          "dest": "timeout",
+          "required": false,
+          "help": "HTTP timeout in seconds",
+          "kind": "integer",
+          "action": "store",
+          "default_when_omitted": 30,
+          "default": 30,
+          "flags": [
+            "--timeout"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "output",
+          "required": false,
+          "help": "Output mode",
+          "kind": "string",
+          "action": "store",
+          "choices": [
+            "json",
+            "ndjson",
+            "human"
+          ],
+          "default_when_omitted": "json",
+          "default": "json",
+          "flags": [
+            "--output"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "compact",
+          "required": false,
+          "help": "Print compact JSON",
+          "kind": "boolean",
+          "action": "store_true",
+          "nargs": 0,
+          "default_when_omitted": false,
+          "value_when_present": true,
+          "flags": [
+            "--compact"
+          ],
+          "takes_value": false
+        },
+        {
+          "dest": "select",
+          "required": false,
+          "help": "Extract a dotted field path from the final result (for example: id or items.0.id)",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--select"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "json_pointer",
+          "required": false,
+          "help": "Extract a JSON pointer from the final result (for example: /id)",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--json-pointer"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "verbose",
+          "required": false,
+          "help": "Print request metadata to stderr",
+          "kind": "boolean",
+          "action": "store_true",
+          "nargs": 0,
+          "default_when_omitted": false,
+          "value_when_present": true,
+          "flags": [
+            "--verbose"
+          ],
+          "takes_value": false
+        }
+      ],
+      "mutually_exclusive_groups": [
+        {
+          "required": false,
+          "options": [
+            "--select",
+            "--json-pointer"
+          ]
+        }
+      ],
+      "subcommands": [],
+      "leaf_command": true,
+      "auth_mode": "developer_key_or_user_session",
+      "destructive": false,
+      "output_contract": {
+        "modes": [
+          "json",
+          "ndjson",
+          "human"
+        ],
+        "json": {
+          "single_document": true
+        },
+        "ndjson": {
+          "streaming": true,
+          "recommended_for": "progress updates / watch flows"
+        },
+        "human": {
+          "interactive": true
+        }
+      },
+      "availability": null,
+      "examples": [
+        "autotouch columns move [-h] --table-id TABLE_ID --column-id COLUMN_ID\n                              [--after-column-id AFTER_COLUMN_ID]\n                              [--before-column-id BEFORE_COLUMN_ID]\n                              [--base-url BASE_URL] [--token TOKEN]\n                              [--use-x-api-key] [--timeout TIMEOUT]\n                              [--output {json,ndjson,human}] [--compact]\n                              [--select SELECT | --json-pointer JSON_POINTER]\n                              [--verbose]"
+      ],
+      "stability": "stable",
+      "handler": "cmd_columns_move"
+    },
     "columns.delete": {
       "canonical": [
         "autotouch",
@@ -13877,6 +14141,28 @@
           ],
           "takes_value": true
         },
+        {
+          "dest": "after_column_id",
+          "required": false,
+          "help": "Place the new projection group after this existing column id",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--after-column-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "before_column_id",
+          "required": false,
+          "help": "Place the new projection group before this existing column id",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--before-column-id"
+          ],
+          "takes_value": true
+        },
         {
           "dest": "base_url",
           "required": false,
@@ -14030,7 +14316,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch columns projections [-h] --table-id TABLE_ID\n                                     [--data-json DATA_JSON]\n                                     [--data-file DATA_FILE]\n                                     [--base-url BASE_URL] [--token TOKEN]\n                                     [--use-x-api-key] [--timeout TIMEOUT]\n                                     [--output {json,ndjson,human}]\n                                     [--compact] [--select SELECT |\n                                     --json-pointer JSON_POINTER] [--verbose]"
+        "autotouch columns projections [-h] --table-id TABLE_ID\n                                     [--data-json DATA_JSON]\n                                     [--data-file DATA_FILE]\n                                     [--after-column-id AFTER_COLUMN_ID]\n                                     [--before-column-id BEFORE_COLUMN_ID]\n                                     [--base-url BASE_URL] [--token TOKEN]\n                                     [--use-x-api-key] [--timeout TIMEOUT]\n                                     [--output {json,ndjson,human}]\n                                     [--compact] [--select SELECT |\n                                     --json-pointer JSON_POINTER] [--verbose]"
       ],
       "stability": "stable",
       "handler": "cmd_columns_projections"

{autotouch_cli-0.2.48 → autotouch_cli-0.2.50}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.48
+Version: 0.2.50
 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
@@ -157,7 +157,7 @@ Only send `user_schema` / `response_schema` when you intentionally want to overr
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.50/docs/platform/authentication.md

{autotouch_cli-0.2.48 → autotouch_cli-0.2.50}/autotouch_shared/provider_registry.py

@@ -151,6 +151,12 @@ def _text(value: Any) -> str:
     return str(value or "").strip()
 
 
+def _mapping_text(value: Any) -> str:
+    if isinstance(value, dict):
+        return _text(value.get("column"))
+    return _text(value)
+
+
 def _llm_provider_values() -> Tuple[str, ...]:
     return ("gemini", "xai", "openai", "anthropic", "groq")
 
@@ -515,6 +521,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         recipe_notes=(
             "For non-LinkedIn lookup, use lookupStrategy=domain/company with firstName+lastName+domain/company fields.",
+            "Primitive source columns map directly. If an upstream source column stores structured JSON, map it as an object with column + path, for example {\"column\": \"linkedin_lookup\", \"path\": \"linkedin_url\"}.",
         ),
         column_type={
             "type": "email_finder",
@@ -541,6 +548,13 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "strategy_field": "config.strategy",
             "lookup_strategy_field": "config.lookupStrategy",
             "input_fields": ["config.linkedinUrl", "config.firstName", "config.lastName", "config.company", "config.domain"],
+            "structured_source_mapping": {
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "examples": [
+                    {"linkedinUrl": {"column": "linkedin_lookup", "path": "linkedin_url"}},
+                    {"emailColumn": {"column": "email_validation", "path": "response"}},
+                ],
+            },
         },
         composition_contract={
             "consumes": {
@@ -583,6 +597,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         recipe_notes=(
             "You can use linkedinUrl or email/workEmail/personalEmail inputs.",
+            "Primitive source columns map directly. If an upstream source column stores structured JSON, map it as an object with column + path, for example {\"column\": \"linkedin_lookup\", \"path\": \"linkedin_url\"}.",
         ),
         column_type={
             "type": "phone_finder",
@@ -616,6 +631,13 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
                 "config.lastName",
                 "config.company",
             ],
+            "structured_source_mapping": {
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "examples": [
+                    {"linkedinUrl": {"column": "linkedin_lookup", "path": "linkedin_url"}},
+                    {"phoneColumn": {"column": "mobile_phone", "path": "mobile_number"}},
+                ],
+            },
         },
         composition_contract={
             "consumes": {
@@ -662,6 +684,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         recipe_notes=(
             "Add more targeting keys as needed (jobFunctions, seniorities, keywords, excludeKeywords, skills).",
+            "Primitive source columns map directly. If companyDomain or other mapped inputs come from structured JSON, use {\"column\": \"...\", \"path\": \"...\"} instead of a plain string column key.",
         ),
         column_type={
             "type": "lead_finder",
@@ -687,6 +710,12 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "source_mode_field": "config.sourceMode",
             "company_domain_field": "config.companyDomain",
             "max_results_field": "config.maxResults",
+            "structured_source_mapping": {
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "examples": [
+                    {"companyDomain": {"column": "company_lookup", "path": "domain"}},
+                ],
+            },
         },
         composition_contract={
             "consumes": {
@@ -758,7 +787,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "companyDomain is required; LinkedIn is optional.",
             "Include at least one usable hard-identity mapping such as LinkedIn, email, or phone.",
             "If companyDomain is missing in the table, derive or enrich that domain column first.",
-            "Primitive source columns map directly. Structured JSON columns must specify an explicit path such as work_email.response or mobile_phone.mobile_number.",
+            "Primitive source columns map directly. If a mapped source column stores structured JSON, send an object with column + path, for example {\"column\": \"work_email\", \"path\": \"response\"} or {\"column\": \"mobile_phone\", \"path\": \"mobile_number\"}.",
             "Add to CRM is optional and non-billable.",
             "Creating add_to_crm after upstream email/phone/lead columns already finished does not replay those older source updates; run add_to_crm explicitly or rerun the upstream source column.",
         ),
@@ -785,18 +814,19 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "eligibility": "company domain plus at least one valid LinkedIn URL, email, or phone must resolve from mapped source columns",
             "replay_behavior": "source updates only; explicit run required to backfill older upstream results",
             "structured_source_mapping": {
-                "rule": "primitive columns map directly; structured columns require explicit path",
-                "field": "config.fieldMappings.*.path",
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "field": "config.fieldMappings.*",
                 "examples": [
-                    "emailAddresses[].path = response",
-                    "phoneNumbers[].path = mobile_number",
+                    {"emailAddresses": [{"column": "work_email", "path": "response", "type": "work"}]},
+                    {"phoneNumbers": [{"column": "mobile_phone", "path": "mobile_number", "type": "mobile"}]},
+                    {"linkedinUrl": {"column": "linkedin_lookup", "path": "linkedin_url"}},
                 ],
             },
         },
         composition_contract={
             "consumes": {
                 "kind": "crm_export_inputs",
-                "shape": "mapped source row values including company domain plus LinkedIn/email/phone identity; structured source columns must identify the exact JSON key via path",
+                "shape": "mapped source row values including company domain plus LinkedIn/email/phone identity; structured source columns use explicit {column, path} mappings to identify the exact field",
             },
             "produces": {
                 "kind": "lead_ids",
@@ -1276,30 +1306,39 @@ def validate_column_provider_contract(
 
     if contract.key == "email_finder":
         if not any(
-            _text(cfg.get(field_name))
-            for field_name in ("linkedinUrl", "firstName", "lastName", "company", "domain")
+            _mapping_text(cfg.get(field_name))
+            for field_name in ("linkedinUrl", "firstName", "lastName", "company", "domain", "emailColumn")
         ):
             raise ProviderContractValidationError(
                 "missing_required_field",
-                "email_finder requires at least one lookup input such as config.linkedinUrl, config.domain, or name/company fields.",
+                "email_finder requires at least one lookup input such as config.linkedinUrl, config.domain, config.emailColumn, or name/company fields.",
                 hint="Use `autotouch columns recipe --type email_finder`.",
             )
         return contract
 
     if contract.key == "phone_finder":
         if not any(
-            _text(cfg.get(field_name))
-            for field_name in ("linkedinUrl", "email", "workEmail", "personalEmail", "firstName", "lastName", "company")
+            _mapping_text(cfg.get(field_name))
+            for field_name in (
+                "linkedinUrl",
+                "email",
+                "workEmail",
+                "personalEmail",
+                "firstName",
+                "lastName",
+                "company",
+                "phoneColumn",
+            )
         ):
             raise ProviderContractValidationError(
                 "missing_required_field",
-                "phone_finder requires at least one lookup input such as config.linkedinUrl or config.email/workEmail.",
+                "phone_finder requires at least one lookup input such as config.linkedinUrl, config.email/workEmail, or config.phoneColumn.",
                 hint="Use `autotouch columns recipe --type phone_finder`.",
             )
         return contract
 
     if contract.key == "lead_finder":
-        if not _text(cfg.get("companyDomain")):
+        if not _mapping_text(cfg.get("companyDomain")):
             raise ProviderContractValidationError(
                 "missing_required_field",
                 "lead_finder requires config.companyDomain.",

{autotouch_cli-0.2.48 → autotouch_cli-0.2.50}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "autotouch-cli"
-version = "0.2.48"
+version = "0.2.50"
 description = "Autotouch Smart Table CLI"
 readme = "README.md"
 requires-python = ">=3.9"