autotouch-cli 0.2.35__tar.gz → 0.2.36__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/MANIFEST.in +2 -0
  2. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/PKG-INFO +17 -16
  3. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/README.md +16 -15
  4. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_cli/cli.py +443 -824
  5. autotouch_cli-0.2.36/autotouch_cli/cli_contracts.py +391 -0
  6. autotouch_cli-0.2.36/autotouch_cli/data/CLI_REFERENCE.md +4721 -0
  7. autotouch_cli-0.2.36/autotouch_cli/data/cli-manifest.json +25236 -0
  8. autotouch_cli-0.2.36/autotouch_cli/mongo_status.py +39 -0
  9. autotouch_cli-0.2.36/autotouch_cli/parser_groups.py +215 -0
  10. autotouch_cli-0.2.36/autotouch_cli/templates.py +1092 -0
  11. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/PKG-INFO +17 -16
  12. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/SOURCES.txt +6 -0
  13. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_shared/provider_registry.py +210 -2
  14. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/pyproject.toml +4 -1
  15. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_cli/__init__.py +0 -0
  16. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/dependency_links.txt +0 -0
  17. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/entry_points.txt +0 -0
  18. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/requires.txt +0 -0
  19. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/top_level.txt +0 -0
  20. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_shared/__init__.py +0 -0
  21. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_shared/linkedin_contract.py +0 -0
  22. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/autotouch_shared/search_contract.py +0 -0
  23. {autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/setup.cfg +0 -0
{autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/MANIFEST.in RENAMED
@@ -1,4 +1,6 @@
1
1
  exclude docs/research-table/reference/autotouch-cli.md
2
+ recursive-include autotouch_cli/data *.json
3
+ recursive-include autotouch_cli/data *.md
2
4
  prune scripts
3
5
  prune tests
4
6
  prune build
{autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: autotouch-cli
3
- Version: 0.2.35
3
+ Version: 0.2.36
4
4
  Summary: Autotouch Smart Table CLI
5
5
  Requires-Python: >=3.9
6
6
  Description-Content-Type: text/markdown
@@ -11,10 +11,13 @@ Requires-Dist: python-dotenv>=1.0.0
11
11
 
12
12
  Installable CLI for the Smart Table developer API.
13
13
 
14
- Use it when you want command-driven access to tables, columns, runs, jobs, leads, sequences, and task workflows without hand-writing raw HTTP requests.
14
+ Use it when you want command-driven access to search, tables, columns, runs, jobs, leads, sequences, and task workflows without hand-writing raw HTTP requests.
15
15
 
16
16
  The CLI talks to the same API the product uses. For automation, prefer `--output json`.
17
17
 
18
+ For a machine-readable local command contract, use `autotouch cli-manifest --output json`.
19
+ For a shipped human-readable reference generated from the installed parser, use `autotouch cli-reference`.
20
+
18
21
  ## Install
19
22
 
20
23
  ```bash
@@ -64,32 +67,28 @@ autotouch setup --api-key stk_... --base-url https://app.autotouch.ai
64
67
  autotouch capabilities --output json
65
68
 
66
69
  # 2) Create a table and capture its id
67
- autotouch tables create --name "CLI Contacts" --output json > table.json
68
- TABLE_ID=$(python3 -c 'import json; print(json.load(open("table.json"))["id"])')
70
+ TABLE_ID=$(autotouch tables create --name "CLI Contacts" --output json --select id)
69
71
 
70
72
  # 3) Add a couple rows with the default lead_finder recipe's expected field
71
- autotouch rows add \
73
+ ROW_ID=$(autotouch rows add \
72
74
  --table-id "$TABLE_ID" \
73
75
  --records-json '[{"domain":"openai.com","companyName":"OpenAI"},{"domain":"stripe.com","companyName":"Stripe"}]' \
74
- --output json > rows.json
75
- ROW_ID=$(python3 -c 'import json; print((json.load(open("rows.json")).get("rowIds") or [None])[0])')
76
+ --output json --select rowIds.0)
76
77
 
77
78
  # 4) Generate a provider-backed column payload
78
79
  autotouch columns recipe --type lead_finder --out-file column.json
79
80
 
80
81
  # 5) Create the column and capture its id
81
- autotouch columns create --table-id "$TABLE_ID" --data-file column.json --output json > column-create.json
82
- COLUMN_ID=$(python3 -c 'import json; print(json.load(open("column-create.json"))["id"])')
82
+ COLUMN_ID=$(autotouch columns create --table-id "$TABLE_ID" --data-file column.json --output json --select id)
83
83
 
84
84
  # 6) Run a small controlled slice and capture the bulk job id
85
- autotouch columns run-next \
85
+ JOB_ID=$(autotouch columns run-next \
86
86
  --table-id "$TABLE_ID" \
87
87
  --column-id "$COLUMN_ID" \
88
88
  --count 10 \
89
89
  --show-estimate \
90
90
  --wait \
91
- --output json > run.json
92
- JOB_ID=$(python3 -c 'import json; payload=json.load(open("run.json")); print(payload.get("job_id") or payload.get("jobId"))')
91
+ --output json --select job_id)
93
92
 
94
93
  # 7) Verify backend truth
95
94
  autotouch jobs get --job-id "$JOB_ID" --output json
@@ -105,6 +104,7 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
105
104
  - Inspect rows: `autotouch rows list`, `autotouch rows get`
106
105
  - Inspect one cell: `autotouch cells get`
107
106
  - Create a workflow column: `autotouch columns recipe`, `autotouch columns create`
107
+ - Run provider-hidden search: `autotouch search companies`, `autotouch search people`
108
108
  - Run controlled slices: `autotouch columns run-next`
109
109
  - Poll authoritative state: `autotouch jobs get`
110
110
  - Create/activate sequences: `autotouch sequences recipe`, `autotouch sequences create`, `autotouch sequences activate`
@@ -120,6 +120,7 @@ autotouch capabilities --output json
120
120
 
121
121
  Important sections:
122
122
 
123
+ - `cli-manifest`: local command grammar, flags, aliases, and output contracts shipped with the CLI
123
124
  - `automation.providers`: provider setup contracts
124
125
  - `automation.workflow_blueprints`: common multi-step workflow patterns
125
126
  - `inspection.research_table`: exact row/cell audit endpoints and audit loop
@@ -136,7 +137,7 @@ Use a dedicated `AUTOTOUCH_CONFIG_PATH` if you want a clean local account instea
136
137
 
137
138
  ## Docs
138
139
 
139
- - Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.32/docs/research-table/reference/autotouch-cli.md
140
- - Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.32/docs/research-table/guides/autotouch-cli-agent-playbook.md
141
- - Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.32/docs/research-table/reference/tables-api.md
142
- - Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.32/docs/platform/authentication.md
140
+ - Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.35/docs/research-table/reference/autotouch-cli.md
141
+ - Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.35/docs/research-table/guides/autotouch-cli-agent-playbook.md
142
+ - Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.35/docs/research-table/reference/tables-api.md
143
+ - Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.35/docs/platform/authentication.md
{autotouch_cli-0.2.35 → autotouch_cli-0.2.36}/README.md RENAMED
@@ -2,10 +2,13 @@
2
2
 
3
3
  Installable CLI for the Smart Table developer API.
4
4
 
5
- Use it when you want command-driven access to tables, columns, runs, jobs, leads, sequences, and task workflows without hand-writing raw HTTP requests.
5
+ Use it when you want command-driven access to search, tables, columns, runs, jobs, leads, sequences, and task workflows without hand-writing raw HTTP requests.
6
6
 
7
7
  The CLI talks to the same API the product uses. For automation, prefer `--output json`.
8
8
 
9
+ For a machine-readable local command contract, use `autotouch cli-manifest --output json`.
10
+ For a shipped human-readable reference generated from the installed parser, use `autotouch cli-reference`.
11
+
9
12
  ## Install
10
13
 
11
14
  ```bash
@@ -55,32 +58,28 @@ autotouch setup --api-key stk_... --base-url https://app.autotouch.ai
55
58
  autotouch capabilities --output json
56
59
 
57
60
  # 2) Create a table and capture its id
58
- autotouch tables create --name "CLI Contacts" --output json > table.json
59
- TABLE_ID=$(python3 -c 'import json; print(json.load(open("table.json"))["id"])')
61
+ TABLE_ID=$(autotouch tables create --name "CLI Contacts" --output json --select id)
60
62
 
61
63
  # 3) Add a couple rows with the default lead_finder recipe's expected field
62
- autotouch rows add \
64
+ ROW_ID=$(autotouch rows add \
63
65
  --table-id "$TABLE_ID" \
64
66
  --records-json '[{"domain":"openai.com","companyName":"OpenAI"},{"domain":"stripe.com","companyName":"Stripe"}]' \
65
- --output json > rows.json
66
- ROW_ID=$(python3 -c 'import json; print((json.load(open("rows.json")).get("rowIds") or [None])[0])')
67
+ --output json --select rowIds.0)
67
68
 
68
69
  # 4) Generate a provider-backed column payload
69
70
  autotouch columns recipe --type lead_finder --out-file column.json
70
71
 
71
72
  # 5) Create the column and capture its id
72
- autotouch columns create --table-id "$TABLE_ID" --data-file column.json --output json > column-create.json
73
- COLUMN_ID=$(python3 -c 'import json; print(json.load(open("column-create.json"))["id"])')
73
+ COLUMN_ID=$(autotouch columns create --table-id "$TABLE_ID" --data-file column.json --output json --select id)
74
74
 
75
75
  # 6) Run a small controlled slice and capture the bulk job id
76
- autotouch columns run-next \
76
+ JOB_ID=$(autotouch columns run-next \
77
77
  --table-id "$TABLE_ID" \
78
78
  --column-id "$COLUMN_ID" \
79
79
  --count 10 \
80
80
  --show-estimate \
81
81
  --wait \
82
- --output json > run.json
83
- JOB_ID=$(python3 -c 'import json; payload=json.load(open("run.json")); print(payload.get("job_id") or payload.get("jobId"))')
82
+ --output json --select job_id)
84
83
 
85
84
  # 7) Verify backend truth
86
85
  autotouch jobs get --job-id "$JOB_ID" --output json
@@ -96,6 +95,7 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
96
95
  - Inspect rows: `autotouch rows list`, `autotouch rows get`
97
96
  - Inspect one cell: `autotouch cells get`
98
97
  - Create a workflow column: `autotouch columns recipe`, `autotouch columns create`
98
+ - Run provider-hidden search: `autotouch search companies`, `autotouch search people`
99
99
  - Run controlled slices: `autotouch columns run-next`
100
100
  - Poll authoritative state: `autotouch jobs get`
101
101
  - Create/activate sequences: `autotouch sequences recipe`, `autotouch sequences create`, `autotouch sequences activate`
@@ -111,6 +111,7 @@ autotouch capabilities --output json
111
111
 
112
112
  Important sections:
113
113
 
114
+ - `cli-manifest`: local command grammar, flags, aliases, and output contracts shipped with the CLI
114
115
  - `automation.providers`: provider setup contracts
115
116
  - `automation.workflow_blueprints`: common multi-step workflow patterns
116
117
  - `inspection.research_table`: exact row/cell audit endpoints and audit loop
@@ -127,7 +128,7 @@ Use a dedicated `AUTOTOUCH_CONFIG_PATH` if you want a clean local account instea
127
128
 
128
129
  ## Docs
129
130
 
130
- - Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.32/docs/research-table/reference/autotouch-cli.md
131
- - Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.32/docs/research-table/guides/autotouch-cli-agent-playbook.md
132
- - Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.32/docs/research-table/reference/tables-api.md
133
- - Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.32/docs/platform/authentication.md
131
+ - Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.35/docs/research-table/reference/autotouch-cli.md
132
+ - Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.35/docs/research-table/guides/autotouch-cli-agent-playbook.md
133
+ - Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.35/docs/research-table/reference/tables-api.md
134
+ - Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.35/docs/platform/authentication.md