autotouch-cli 0.2.34__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.
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/MANIFEST.in +2 -0
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/PKG-INFO +17 -16
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/README.md +16 -15
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/autotouch_cli/cli.py +785 -824
- autotouch_cli-0.2.36/autotouch_cli/cli_contracts.py +391 -0
- autotouch_cli-0.2.36/autotouch_cli/data/CLI_REFERENCE.md +4721 -0
- autotouch_cli-0.2.36/autotouch_cli/data/cli-manifest.json +25236 -0
- autotouch_cli-0.2.36/autotouch_cli/mongo_status.py +39 -0
- autotouch_cli-0.2.36/autotouch_cli/parser_groups.py +215 -0
- autotouch_cli-0.2.36/autotouch_cli/templates.py +1092 -0
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/PKG-INFO +17 -16
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/SOURCES.txt +8 -1
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/autotouch_shared/linkedin_contract.py +24 -0
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/autotouch_shared/provider_registry.py +210 -2
- autotouch_cli-0.2.36/autotouch_shared/search_contract.py +233 -0
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/pyproject.toml +4 -1
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/autotouch_cli/__init__.py +0 -0
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/dependency_links.txt +0 -0
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/entry_points.txt +0 -0
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/requires.txt +0 -0
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/autotouch_cli.egg-info/top_level.txt +0 -0
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/autotouch_shared/__init__.py +0 -0
- {autotouch_cli-0.2.34 → autotouch_cli-0.2.36}/setup.cfg +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: autotouch-cli
|
|
3
|
-
Version: 0.2.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
140
|
-
- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.
|
|
141
|
-
- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.
|
|
142
|
-
- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.
|
|
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
|
|
@@ -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
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
131
|
-
- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.
|
|
132
|
-
- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.
|
|
133
|
-
- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.
|
|
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
|