sinapsis_cli 1.0.0__py3-none-any.whl

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 (46) hide show
  1. sinapsis_cli/__init__.py +13 -0
  2. sinapsis_cli/commands/__init__.py +0 -0
  3. sinapsis_cli/commands/cloud/__init__.py +0 -0
  4. sinapsis_cli/commands/cloud/_agent_selection.py +112 -0
  5. sinapsis_cli/commands/cloud/_secrets_render.py +15 -0
  6. sinapsis_cli/commands/cloud/_webhook_render.py +19 -0
  7. sinapsis_cli/commands/cloud/agents.py +137 -0
  8. sinapsis_cli/commands/cloud/api_keys.py +155 -0
  9. sinapsis_cli/commands/cloud/files.py +135 -0
  10. sinapsis_cli/commands/cloud/jobs.py +532 -0
  11. sinapsis_cli/commands/cloud/packages.py +164 -0
  12. sinapsis_cli/commands/cloud/schedules.py +392 -0
  13. sinapsis_cli/commands/cloud/secrets.py +96 -0
  14. sinapsis_cli/commands/cloud/templates.py +95 -0
  15. sinapsis_cli/commands/cloud/webhooks.py +156 -0
  16. sinapsis_cli/commands/common/__init__.py +0 -0
  17. sinapsis_cli/commands/common/auth.py +219 -0
  18. sinapsis_cli/commands/common/profiles.py +156 -0
  19. sinapsis_cli/commands/common/telemetry.py +150 -0
  20. sinapsis_cli/commands/local_api/__init__.py +0 -0
  21. sinapsis_cli/commands/local_api/jobs.py +284 -0
  22. sinapsis_cli/commands/local_venv/__init__.py +0 -0
  23. sinapsis_cli/commands/local_venv/_templates_render.py +56 -0
  24. sinapsis_cli/commands/local_venv/jobs.py +76 -0
  25. sinapsis_cli/commands/local_venv/templates.py +47 -0
  26. sinapsis_cli/composition.py +215 -0
  27. sinapsis_cli/config.py +446 -0
  28. sinapsis_cli/execution.py +77 -0
  29. sinapsis_cli/main.py +185 -0
  30. sinapsis_cli/main_multi.py +152 -0
  31. sinapsis_cli/shared/__init__.py +3 -0
  32. sinapsis_cli/shared/jobs.py +134 -0
  33. sinapsis_cli/shared/terminal.py +8 -0
  34. sinapsis_cli/shared/writer.py +427 -0
  35. sinapsis_cli/state.py +310 -0
  36. sinapsis_cli/telemetry/__init__.py +7 -0
  37. sinapsis_cli/telemetry/collector.py +84 -0
  38. sinapsis_cli/telemetry/core.py +331 -0
  39. sinapsis_cli/telemetry/scheduler.py +234 -0
  40. sinapsis_cli/telemetry/transport.py +150 -0
  41. sinapsis_cli-1.0.0.dist-info/METADATA +386 -0
  42. sinapsis_cli-1.0.0.dist-info/RECORD +46 -0
  43. sinapsis_cli-1.0.0.dist-info/WHEEL +4 -0
  44. sinapsis_cli-1.0.0.dist-info/entry_points.txt +5 -0
  45. sinapsis_cli-1.0.0.dist-info/licenses/LICENSE-APACHE +202 -0
  46. sinapsis_cli-1.0.0.dist-info/licenses/LICENSE-MIT +21 -0
@@ -0,0 +1,150 @@
1
+ """Automatic, best-effort telemetry delivery using durable SQLite acknowledgements.
2
+
3
+ Events are not removed from the pending queue on network failures. Only UUIDs
4
+ acknowledged by the server are marked sent. HTTP operations are bounded and
5
+ never propagate exceptions into an ordinary CLI command.
6
+ """
7
+ from __future__ import annotations
8
+
9
+ import json
10
+ import os
11
+ import sqlite3
12
+ import time
13
+ import urllib.error
14
+ import urllib.parse
15
+ import urllib.request
16
+ from datetime import UTC, datetime
17
+ from typing import Any
18
+
19
+ from sinapsis_cli.telemetry.core import _connect, collection_enabled
20
+
21
+ DEFAULT_ENDPOINT = 'https://api.sinapsis.tech/api/v1/telemetry/events'
22
+ BATCH_SIZE = 40
23
+ MAX_BODY_BYTES = 65536
24
+ CONNECT_TIMEOUT_SECONDS = 1.5
25
+ MAX_PENDING_EVENTS = 10000
26
+
27
+
28
+ def _ensure_schema(conn: sqlite3.Connection) -> None:
29
+ """Add publisher columns without losing events from the prior local patch."""
30
+ columns = {item[1] for item in conn.execute('PRAGMA table_info(events)')}
31
+ if 'lease_until' not in columns:
32
+ conn.execute('ALTER TABLE events ADD COLUMN lease_until REAL DEFAULT 0')
33
+ if 'attempts' not in columns:
34
+ conn.execute('ALTER TABLE events ADD COLUMN attempts INTEGER NOT NULL DEFAULT 0')
35
+ conn.execute('CREATE INDEX IF NOT EXISTS events_pending ON events(sent_at,lease_until)')
36
+
37
+
38
+ def queue_status() -> dict[str, Any]:
39
+ """Report real local delivery state, without creating a database."""
40
+ try:
41
+ conn = _connect()
42
+ if conn is None:
43
+ return {'pending': 0, 'sent': 0, 'last_sent': None}
44
+ with conn:
45
+ _ensure_schema(conn)
46
+ pending = conn.execute('SELECT count(*) FROM events WHERE sent_at IS NULL').fetchone()[0]
47
+ sent = conn.execute('SELECT count(*) FROM events WHERE sent_at IS NOT NULL').fetchone()[0]
48
+ last = conn.execute('SELECT sent_at,payload FROM events WHERE sent_at IS NOT NULL '
49
+ 'ORDER BY sent_at DESC,rowid DESC LIMIT 1').fetchone()
50
+ conn.close()
51
+ return {'pending': int(pending), 'sent': int(sent),
52
+ 'last_sent': {'acknowledged_at': last[0], 'payload': json.loads(last[1])} if last else None}
53
+ except (sqlite3.Error, OSError, ValueError):
54
+ return {'pending': 0, 'sent': 0, 'last_sent': None, 'error': 'Could not read telemetry journal'}
55
+
56
+
57
+ def _claim() -> list[dict[str, Any]]:
58
+ """Atomically lease pending events so concurrent CLI processes cannot collide."""
59
+ conn = _connect()
60
+ if conn is None:
61
+ return []
62
+ try:
63
+ conn.execute('BEGIN IMMEDIATE')
64
+ _ensure_schema(conn)
65
+ rows = conn.execute(
66
+ 'SELECT event_id,payload FROM events WHERE sent_at IS NULL AND '
67
+ 'COALESCE(lease_until,0) <= ? ORDER BY timestamp, rowid LIMIT ?',
68
+ (time.time(), BATCH_SIZE),
69
+ ).fetchall()
70
+ for event_id, _ in rows:
71
+ conn.execute('UPDATE events SET lease_until=?, attempts=attempts+1 WHERE event_id=?',
72
+ (time.time()+90, event_id))
73
+ conn.commit()
74
+ return [json.loads(row[1]) for row in rows]
75
+ except (OSError, sqlite3.Error, ValueError):
76
+ conn.rollback()
77
+ return []
78
+ finally:
79
+ conn.close()
80
+
81
+
82
+ def _release(ids: set[str], *, acknowledged: set[str]) -> None:
83
+ """Mark only server-acknowledged IDs as sent; release all other leases."""
84
+ try:
85
+ conn = _connect()
86
+ if conn is None:
87
+ return
88
+ with conn:
89
+ for identifier in ids:
90
+ if identifier in acknowledged:
91
+ conn.execute('UPDATE events SET sent_at=COALESCE(sent_at,?), lease_until=0 WHERE event_id=?',
92
+ (datetime.now(UTC).isoformat(timespec='seconds'), identifier))
93
+ else:
94
+ conn.execute('UPDATE events SET lease_until=0 WHERE event_id=? AND sent_at IS NULL',
95
+ (identifier,))
96
+ conn.close()
97
+ except (sqlite3.Error, OSError):
98
+ pass
99
+
100
+
101
+ def _endpoint() -> str | None:
102
+ value = os.getenv('SINAPSIS_TELEMETRY_ENDPOINT', DEFAULT_ENDPOINT)
103
+ parsed = urllib.parse.urlsplit(value)
104
+ if parsed.scheme != 'https' or parsed.username or parsed.password or not parsed.netloc or parsed.query or parsed.fragment:
105
+ return None
106
+ return value
107
+
108
+
109
+ def publish_pending() -> int:
110
+ """Automatically transmit one bounded batch, returning acknowledged count.
111
+
112
+ Safe to invoke at every CLI exit. Unreachable telemetry must not affect
113
+ command exit status. One event ID is reused across every retry.
114
+ """
115
+ if not collection_enabled():
116
+ return 0
117
+ endpoint = _endpoint()
118
+ if endpoint is None:
119
+ return 0
120
+ events = _claim()
121
+ if not events:
122
+ return 0
123
+ identifiers = {event['event_id'] for event in events}
124
+ accepted: set[str] = set()
125
+ try:
126
+ # Inventory events can be larger than command events. Never allow one
127
+ # oversized batch to indefinitely prevent every queued event sending.
128
+ while events:
129
+ body = json.dumps({'schema_version': 1, 'events': events}, separators=(',', ':')).encode()
130
+ if len(body) <= MAX_BODY_BYTES:
131
+ break
132
+ events.pop()
133
+ if not events:
134
+ return 0
135
+ request = urllib.request.Request(endpoint, data=body, method='POST',
136
+ headers={'Content-Type': 'application/json',
137
+ 'User-Agent': 'sinapsis-cli-telemetry/1'})
138
+ with urllib.request.urlopen(request, timeout=CONNECT_TIMEOUT_SECONDS) as response:
139
+ if response.status != 200:
140
+ return 0
141
+ result = json.loads(response.read(16 * 1024))
142
+ ack = result.get('acknowledged') if isinstance(result, dict) else None
143
+ if not isinstance(ack, list) or not all(isinstance(x, str) for x in ack):
144
+ return 0
145
+ accepted = set(ack) & identifiers
146
+ return len(accepted)
147
+ except (OSError, TimeoutError, ValueError, TypeError, urllib.error.URLError):
148
+ return 0
149
+ finally:
150
+ _release(identifiers, acknowledged=accepted)
@@ -0,0 +1,386 @@
1
+ Metadata-Version: 2.5
2
+ Name: sinapsis_cli
3
+ Version: 1.0.0
4
+ Summary: Sinapsis CLI for interaction with sinapsis services locally through a venv, docker or remotely with the sinapsis cloud api
5
+ Project-URL: Homepage, https://sinapsis.tech
6
+ Project-URL: Documentation, https://docs.sinapsis.tech/docs/latest
7
+ Project-URL: Tutorials, https://docs.sinapsis.tech/docs/latest/tutorials
8
+ Project-URL: Repository, https://github.com/SinapsisHub/sinapsis-hub
9
+ Project-URL: Issues, https://github.com/SinapsisHub/sinapsis-hub/issues
10
+ Project-URL: Discord, https://discord.gg/uuBqQqu2vS
11
+ Author-email: Ariel Ruiz-Garcia <ariel@sinapsis.tech>, Nimesh Patel <nimesh@sinapsis.tech>
12
+ Maintainer-email: sinapsis <dev@sinapsis.tech>
13
+ License-Expression: MIT OR Apache-2.0
14
+ License-File: LICENSE-APACHE
15
+ License-File: LICENSE-MIT
16
+ Requires-Python: >=3.13
17
+ Requires-Dist: click>=8.4.2
18
+ Requires-Dist: keyring>=25.7.0
19
+ Requires-Dist: platformdirs>=4.11.3
20
+ Requires-Dist: pyperclip>=1.11.0
21
+ Requires-Dist: sinapsis-contracts<2,>=1.0.0
22
+ Requires-Dist: sinapsis-sdk<2,>=1.0.0
23
+ Requires-Dist: sinapsis<2,>=1
24
+ Requires-Dist: supabase>=2.31.0
25
+ Requires-Dist: tomli-w>=1.2.0
26
+ Requires-Dist: tomli>=2.0.0; python_full_version < '3.11'
27
+ Requires-Dist: typer>=0.27.1
28
+ Description-Content-Type: text/markdown
29
+
30
+ <h1 align="center">
31
+ <br>
32
+ <a href="https://sinapsis.tech/">
33
+ <img
34
+ src="https://github.com/SinapsisHub/brand-resources/blob/main/public/logo/sinapsis-logo-horizontal-dark-brand.png?raw=true"
35
+ alt="Sinapsis"
36
+ width="300">
37
+ </a>
38
+ <br>
39
+ Sinapsis CLI
40
+ <br>
41
+ </h1>
42
+
43
+ <p align="center">
44
+ Run Agents, inspect Templates, and manage local or Cloud workloads from your terminal.
45
+ </p>
46
+
47
+ <p align="center">
48
+ <a href="#installation">Installation</a> ·
49
+ <a href="#execution-profiles">Profiles</a> ·
50
+ <a href="#running-agents">Jobs</a> ·
51
+ <a href="#cloud-features">Cloud features</a> ·
52
+ <a href="Scheduling.md">Scheduling</a> ·
53
+ <a href="#shell-autocompletion">Autocompletion</a>
54
+ </p>
55
+
56
+ ## Installation
57
+
58
+ **Python 3.13 or newer** is required. The CLI is published as `sinapsis-cli` and installs the `sinx`, `sinx-venv`, `sinx-api`, and `sinx-cloud` commands.
59
+
60
+ Install it as a standalone CLI with [uv](https://docs.astral.sh/uv/):
61
+
62
+ ```bash
63
+ uv tool install sinapsis-cli
64
+ ```
65
+
66
+ Or install it in a Python environment:
67
+
68
+ ```bash
69
+ uv pip install sinapsis-cli
70
+ # or
71
+ pip install sinapsis-cli
72
+ ```
73
+
74
+ No additional package index is needed for a standard installation.
75
+
76
+ ```bash
77
+ sinx --help
78
+ ```
79
+
80
+ ## Execution profiles
81
+
82
+ Sinapsis CLI supports **three execution backends**. The commands you see depend on the selected profile.
83
+
84
+ | Profile | Entry point | What it does |
85
+ | --- | --- | --- |
86
+ | **Local Python** (`local`) | `sinx-venv` | Runs Agents directly with installed Python packages; inspects locally available Templates. |
87
+ | **Local API** (`local-api`) | `sinx-api` | Submits and manages jobs using a local Sinapsis API. |
88
+ | **Cloud** (`cloud`) | `sinx-cloud` | Runs Cloud jobs and manages saved Agents, Templates, files, integrations, and account resources. |
89
+
90
+ `sinx` uses your configured **default profile**, initially `local`. You can override it for an individual invocation:
91
+
92
+ ```bash
93
+ sinx jobs run agent.yaml # Current default profile
94
+ sinx local jobs run agent.yaml # Direct Python execution
95
+ sinx local-api jobs run agent.yaml # Local API
96
+ sinx cloud jobs run agent.yaml # Cloud API
97
+ ```
98
+
99
+ The dedicated executables are shortcuts for those three built-in profiles:
100
+
101
+ ```bash
102
+ sinx-venv jobs run agent.yaml
103
+ sinx-api jobs run agent.yaml
104
+ sinx-cloud jobs run agent.yaml
105
+ ```
106
+
107
+ > Selecting or configuring `cloud` does **not** automatically change the default profile used by `sinx`.
108
+
109
+ ### Configure a profile
110
+
111
+ ```bash
112
+ # Configure only Cloud, including account sign-in
113
+ sinx-cloud configure
114
+
115
+ # Configure only the local API
116
+ sinx-api configure
117
+
118
+ # Configure only direct local execution
119
+ sinx-venv configure
120
+
121
+ # Interactive setup of all profiles and the default profile
122
+ sinx configure
123
+ ```
124
+
125
+ **New to Sinapsis Cloud?** Visit **[sinapsis.tech](https://sinapsis.tech/)** to create an account before running `sinx-cloud configure`.
126
+
127
+ To inspect your current configuration:
128
+
129
+ ```bash
130
+ sinx profiles list
131
+ sinx-cloud profiles show cloud
132
+ sinx profiles show local
133
+ sinx profiles show local-api
134
+ ```
135
+
136
+ The built-in Cloud API URL is `https://api.sinapsis.tech` and the local API URL defaults to `http://localhost:8000`. `sinx-cloud profiles show cloud` displays the saved Cloud profile settings; it is not an authentication test.
137
+
138
+ ### Choose a default or create another profile
139
+
140
+ ```bash
141
+ sinx profiles default cloud
142
+ sinx profiles default local
143
+
144
+ # Create a second Cloud environment
145
+ sinx profiles create staging --backend cloud --api-url https://YOUR-API-HOST
146
+ sinx staging configure
147
+ sinx staging jobs list
148
+
149
+ # Choose an execution profile just for one terminal session
150
+ SINAPSIS_PROFILE=cloud sinx jobs list
151
+ ```
152
+
153
+ Profiles can also be managed with `sinx profiles delete NAME` and inspected with `sinx profiles show NAME`. Run `sinx profiles --help` for the full profile command reference.
154
+
155
+ ## Running Agents
156
+
157
+ Agent definitions are YAML files that connect reusable Templates. An example:
158
+
159
+ ```yaml
160
+ agent:
161
+ name: hello_world
162
+
163
+ templates:
164
+ - template_name: Input
165
+ class_name: InputTemplate
166
+ attributes: {}
167
+
168
+ - template_name: HelloWorld
169
+ class_name: HelloWorld
170
+ template_input: Input
171
+ attributes:
172
+ display_text: "Hello from Sinapsis!"
173
+ ```
174
+
175
+ Install the Template packages required by your Agent in the environment where it runs. The example requires the corresponding `InputTemplate` and `HelloWorld` implementations.
176
+
177
+ ### Local Python execution
178
+
179
+ Run directly in the selected Python environment:
180
+
181
+ ```bash
182
+ sinx-venv jobs run agent.yaml
183
+ ```
184
+
185
+ Local Python jobs execute directly; the CLI does **not** offer API-style `jobs status`, `jobs stream`, or `jobs cancel` commands for this backend.
186
+
187
+ ### Local API and Cloud jobs
188
+
189
+ Both API-backed profiles support asynchronous job management:
190
+
191
+ ```bash
192
+ # Submit a job
193
+ sinx-api jobs run agent.yaml
194
+ sinx-cloud jobs run agent.yaml
195
+
196
+ # Submit and follow the execution (either API-backed profile)
197
+ sinx-cloud jobs run agent.yaml --wait
198
+ sinx-cloud jobs run agent.yaml --stream
199
+
200
+ # Inspect a job
201
+ sinx-cloud jobs status JOB_ID
202
+ sinx-cloud jobs result JOB_ID
203
+ sinx-cloud jobs stream JOB_ID
204
+ sinx-cloud jobs cancel JOB_ID
205
+ ```
206
+
207
+ The same `jobs status`, `jobs result`, `jobs stream`, and `jobs cancel` subcommands are available under `sinx-api` for local API jobs. An explicit `JOB_ID` can identify a job created elsewhere, subject to access permissions.
208
+
209
+ When a job ID is omitted, the CLI uses the most recent job remembered for the selected profile:
210
+
211
+ ```bash
212
+ sinx-cloud jobs status
213
+ sinx-cloud jobs result
214
+ ```
215
+
216
+ The following additional job options are available:
217
+
218
+ | Option | Availability | Effect |
219
+ | --- | --- | --- |
220
+ | `--wait` | Local API, Cloud | Wait for the job to finish and retrieve results. |
221
+ | `--stream` | Local API, Cloud | Stream execution output. |
222
+ | `--result` | Local API, Cloud | Request retained results after submission. |
223
+ | `--save-dir DIR` / `-o DIR` | Run, result, and stream commands where offered | Choose an output directory for saved artifacts (direct Python execution prints its result). |
224
+ | `--print-only` | All run commands; API results/stream | Print output rather than saving artifacts. |
225
+ | `--refresh` | Cloud `jobs result`, and `jobs run --result` | Retrieve a fresh result rather than a cached one. |
226
+ | `--verbose` / `-v` | Cloud `jobs status` | Include the full Agent definition. |
227
+
228
+ `--wait`, `--stream`, and `--result` are mutually exclusive when used with `jobs run`. For Cloud `jobs run`, `--refresh` requires `--result`.
229
+
230
+ ### Job history
231
+
232
+ Every backend includes a local command history:
233
+
234
+ ```bash
235
+ sinx-venv jobs list
236
+ sinx-api jobs list
237
+ sinx-cloud jobs list
238
+ sinx-cloud jobs list --all-profiles
239
+
240
+ # Clear the remembered jobs for one profile
241
+ sinx-cloud jobs clear
242
+ ```
243
+
244
+ `jobs list` displays **jobs recorded by this CLI**; it is not a list of all jobs held by the Cloud service. Clearing local history does not cancel remote jobs.
245
+
246
+ ## Discover Templates
247
+
248
+ ### Templates installed locally
249
+
250
+ ```bash
251
+ sinx-venv templates show-all
252
+ sinx-venv templates show-all --names-only
253
+ sinx-venv templates docstring TemplateName
254
+ sinx-venv templates example-config TemplateName
255
+ sinx-venv templates example-config TemplateName --output json
256
+ ```
257
+
258
+ Template configuration examples support `pretty`, `json`, and `yaml` output formats.
259
+
260
+ ### Templates available in Cloud
261
+
262
+ ```bash
263
+ sinx-cloud templates list
264
+ sinx-cloud templates search "object detection"
265
+ sinx-cloud templates search "speech" --limit 20
266
+ sinx-cloud templates show TEMPLATE_UUID
267
+ sinx-cloud templates packages
268
+ ```
269
+
270
+ Cloud search also supports `--package`, `--tag`, `--offset`, and `--limit` filters. The Cloud catalogue reflects the Templates and packages accessible to your account; it may differ from what is installed locally.
271
+
272
+ ## Cloud features
273
+
274
+ Cloud adds commands for working with reusable Agents, assets, and integrations. Run `sinx-cloud <group> --help` to see all options.
275
+
276
+ ### Saved Agents and immutable versions
277
+
278
+ ```bash
279
+ sinx-cloud agents register agent.yaml --version v1
280
+ sinx-cloud agents list
281
+ sinx-cloud agents versions AGENT_UUID
282
+ sinx-cloud agents version AGENT_UUID VERSION_UUID
283
+ sinx-cloud agents publish AGENT_UUID updated-agent.yaml --version v2
284
+ ```
285
+
286
+ `register` saves an Agent without executing it. `publish` creates a new immutable version. By default, `agents list` shows explicitly registered Agents; use `agents list --all` to include Agents saved through execution and earlier records.
287
+
288
+ Scheduling an existing Agent version is covered in **[Scheduling.md](Scheduling.md)**, including automatic version selection and recurring runs.
289
+
290
+ ### Files
291
+
292
+ ```bash
293
+ sinx-cloud files upload ./input.csv
294
+ sinx-cloud files list
295
+ sinx-cloud files search input.csv
296
+ sinx-cloud files get FILE_ID --output ./input.csv
297
+ sinx-cloud files fetch AGENT_ID FILE_ID --output ./artifact.bin
298
+ ```
299
+
300
+ `get` retrieves a stored file by ID; `fetch` retrieves a file produced in an Agent's staging area.
301
+
302
+ ### Secrets
303
+
304
+ ```bash
305
+ sinx-cloud secrets create my-service-key # Prompts securely for the value
306
+ sinx-cloud secrets list
307
+ sinx-cloud secrets get SECRET_UUID
308
+ sinx-cloud secrets delete SECRET_UUID
309
+ ```
310
+
311
+ Use the interactive prompt to avoid passing secret values in shell history. `get` displays secret metadata, not the secret value.
312
+
313
+ ### API keys
314
+
315
+ ```bash
316
+ sinx-cloud api-keys permissions
317
+ sinx-cloud api-keys create --name my-integration --scope files:read --expire 7d
318
+ sinx-cloud api-keys list
319
+ sinx-cloud api-keys delete
320
+ ```
321
+
322
+ The CLI supports scopes, expiry durations, and optional Agent restrictions. **Save new API key values when they are created**; they cannot be revealed later.
323
+
324
+ ### Webhooks
325
+
326
+ ```bash
327
+ sinx-cloud webhooks register --help
328
+ sinx-cloud webhooks list
329
+ sinx-cloud webhooks show WEBHOOK_UUID
330
+ sinx-cloud webhooks public-url WEBHOOK_UUID
331
+ sinx-cloud webhooks toggle WEBHOOK_UUID --inactive
332
+ sinx-cloud webhooks delete WEBHOOK_UUID
333
+ ```
334
+
335
+ Webhook registration accepts an integration name, a provider, and optional credential and payload-schema settings.
336
+
337
+ ### Package registry access
338
+
339
+ ```bash
340
+ sinx-cloud packages indexes
341
+ sinx-cloud packages login
342
+ sinx-cloud packages logout
343
+ ```
344
+
345
+ These commands help configure `uv` credentials for supported Sinapsis package indexes. Access to a registry may depend on your account and the registry's availability.
346
+
347
+ ## CLI telemetry controls
348
+
349
+ CLI telemetry is optional and can be inspected or controlled directly:
350
+
351
+ ```bash
352
+ sinx config telemetry status
353
+ sinx config telemetry preview
354
+ sinx config telemetry info
355
+ sinx config telemetry enable
356
+ sinx config telemetry history --limit 10
357
+ sinx config telemetry disable
358
+ sinx config telemetry disable --clear
359
+ ```
360
+
361
+ > Telemetry is off unless enabled or explicitly overridden in the environment. `preview` lets you inspect an example of the information collected without storing or transmitting it.
362
+ > No personal information is ever collected.
363
+
364
+ ## Shell autocompletion
365
+
366
+ Install command, subcommand, and option completion for each executable you use:
367
+
368
+ ```bash
369
+ sinx --install-completion
370
+ sinx-venv --install-completion
371
+ sinx-api --install-completion
372
+ sinx-cloud --install-completion
373
+ ```
374
+
375
+ Restart your shell or reload its configuration after installation. Completion is installed separately for each executable.
376
+
377
+ ## Resources
378
+
379
+ - [Sinapsis documentation](https://docs.sinapsis.tech/)
380
+ - [Tutorials and examples](https://docs.sinapsis.tech/docs/latest/tutorials)
381
+ - [Sinapsis website](https://sinapsis.tech/)
382
+ - [Scheduling and saved Agent versions](SCHEDULING.md)
383
+
384
+ ## License
385
+
386
+ `sinapsis-cli` is dual-licensed under **MIT OR Apache-2.0**.
@@ -0,0 +1,46 @@
1
+ sinapsis_cli/__init__.py,sha256=PdFPGAHdXu7q19QpAcXOofObe5rz9ixnEGIlv1-r5iY,254
2
+ sinapsis_cli/composition.py,sha256=SOVpyD3pQnG617S4L0NaE-Z4eZ6h1RStR1wdwtg80qI,8116
3
+ sinapsis_cli/config.py,sha256=Oa_FI5WdAxUT2BtGs5fAN5uEp8kP7-QQ6GW-C-wuuIc,13977
4
+ sinapsis_cli/execution.py,sha256=Ou6NgAlrbNECFy1_jdca41UBMX5JoW6ysAZ2v4ekRWs,2762
5
+ sinapsis_cli/main.py,sha256=RybidbHnxz0VGpTD78lqT_NeUCIzJ1UoQkVqEZ72qKE,6290
6
+ sinapsis_cli/main_multi.py,sha256=XefYLXAzZtHSKcbTe-j-iCPm2D98noo8WHqfMACe27Q,4446
7
+ sinapsis_cli/state.py,sha256=6z0yEmsKofY3OBpBQ6VJEMCS_XqKnTPwiJz4qHpuyuQ,9663
8
+ sinapsis_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
9
+ sinapsis_cli/commands/cloud/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
10
+ sinapsis_cli/commands/cloud/_agent_selection.py,sha256=tCz_DLpUsdIZprZV1xU0nXQlnc9NCEjFe6lv_p9iJ38,4669
11
+ sinapsis_cli/commands/cloud/_secrets_render.py,sha256=LwdbsEBwAsdg6ALP45SMrg_dgBIBYpJPgTZPacRumv8,542
12
+ sinapsis_cli/commands/cloud/_webhook_render.py,sha256=T_52kSumgL3kcWUnBfljfXbtH3kbpo3010nw5Ilre0s,562
13
+ sinapsis_cli/commands/cloud/agents.py,sha256=sXtq7Gp1yCrRjmXlMWaZjQSOAu5-BVoGSDZPQhj_-eQ,6094
14
+ sinapsis_cli/commands/cloud/api_keys.py,sha256=N-OeacRv9r0MUEt1ooOu9hKi0T_DAMCnAvKp1ad2uW8,5374
15
+ sinapsis_cli/commands/cloud/files.py,sha256=DGO9-2r2qs3nMIJwYMeTI2u75NKYoxuzK9Yqn9J2rv8,4178
16
+ sinapsis_cli/commands/cloud/jobs.py,sha256=GVQF6MZ3cMfU4jXzG47iAtd6nN940JzObQv9kvTNUS8,19911
17
+ sinapsis_cli/commands/cloud/packages.py,sha256=t0feu6BvNI_BiS-JyMPPLLn2gy5VYWqS9tHutG2CFbQ,7084
18
+ sinapsis_cli/commands/cloud/schedules.py,sha256=qqQzm1vFCK0kBvlwqrh458nWe9LZ84P2FRiP8ax200c,15375
19
+ sinapsis_cli/commands/cloud/secrets.py,sha256=RcgmvtxA_dgbyEIKIYmInpU6PKS8TfKerLxmUOXFMq0,3311
20
+ sinapsis_cli/commands/cloud/templates.py,sha256=vxMAIOfM_UJt3EyfK20d4cvkaWBhTHK-uXc5mEsSNeY,3303
21
+ sinapsis_cli/commands/cloud/webhooks.py,sha256=jr1wbFS8Gcej3X2ScHBuk3o4TtsabCEy9qOsT3qG7F0,5390
22
+ sinapsis_cli/commands/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
23
+ sinapsis_cli/commands/common/auth.py,sha256=fUCF6AOkPo11dB-Wi8Cv9VFlPi8RGwkOU9FfrIQ7Nbk,7246
24
+ sinapsis_cli/commands/common/profiles.py,sha256=rSQMAvyrmORe25vqWo7oaPxwJBQSMuuAvmG3JXrIq_8,5004
25
+ sinapsis_cli/commands/common/telemetry.py,sha256=LdWg4TC4wRFFtzofNINUzzTuuTKXKxSv5_NDVqiUqZk,6156
26
+ sinapsis_cli/commands/local_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
27
+ sinapsis_cli/commands/local_api/jobs.py,sha256=HNb8ZTBnizBdgei1Xf1tJP-mKiQljWYL7w4di9CYvOA,11251
28
+ sinapsis_cli/commands/local_venv/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
29
+ sinapsis_cli/commands/local_venv/_templates_render.py,sha256=ewSqTkwnZve4HNgJbtHTpDyb0ls300647Ar0cKonqAA,1801
30
+ sinapsis_cli/commands/local_venv/jobs.py,sha256=OcoIp1FTWbRSdJyTCo2-WieTghV-346EDnAsnBVGFCU,2460
31
+ sinapsis_cli/commands/local_venv/templates.py,sha256=XyBY715zlGF_fRbyNKqUEm_QVk6MaugzNYSgkk3id40,1302
32
+ sinapsis_cli/shared/__init__.py,sha256=A6HQmUdXnaxOgoU1dNP-Ut0_aOJ0AAbvhnNRWJahoyk,61
33
+ sinapsis_cli/shared/jobs.py,sha256=JYCnnhi3-uXN3uHGT6KOhwxurj3RkV8oYou_6xk-5tg,4258
34
+ sinapsis_cli/shared/terminal.py,sha256=nJcapGMG4jDoDDlKpsjf1_wxPiQDB1H0TMJKPMX1A8A,154
35
+ sinapsis_cli/shared/writer.py,sha256=Xk1sWKMW52D7IGOLOBDiqN-NEyTWKuUGI2SDmyvsJng,12510
36
+ sinapsis_cli/telemetry/__init__.py,sha256=mMXRQfu6CBuxjDBF94V0xu2i9YtHTqmzoj0YiRmWNV0,211
37
+ sinapsis_cli/telemetry/collector.py,sha256=bfimFbx1-5Wi798rp2cthKrHybnSmIYyorpP5Y9wELY,3458
38
+ sinapsis_cli/telemetry/core.py,sha256=so_oKegyuALYVuhEH_3DG2WyVa_oBcZxeJyFR7OBjqU,13677
39
+ sinapsis_cli/telemetry/scheduler.py,sha256=AOAmyUoe1vz2g3Srn808NTgvzD18gDJqwEM0Iz4FKn0,9754
40
+ sinapsis_cli/telemetry/transport.py,sha256=QX4JWKk_TStciH4IdIIB1eOi40jYP4KCPctgZgPumPM,6140
41
+ sinapsis_cli-1.0.0.dist-info/METADATA,sha256=1lOKKFFTnSGR6XtspIfk_OnqKwoP9mqs70DhUmpMCJs,12624
42
+ sinapsis_cli-1.0.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
43
+ sinapsis_cli-1.0.0.dist-info/entry_points.txt,sha256=x8zSfBwgYKtOmsvo4dPMRdaJ0JoeimclliJVV0aN1vM,180
44
+ sinapsis_cli-1.0.0.dist-info/licenses/LICENSE-APACHE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
45
+ sinapsis_cli-1.0.0.dist-info/licenses/LICENSE-MIT,sha256=iCOHXEYY1dWKRkzcJLxYZSxr3EbT8zDzS2OgrVytqD0,1079
46
+ sinapsis_cli-1.0.0.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.33.0
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,5 @@
1
+ [console_scripts]
2
+ sinx = sinapsis_cli.main:main
3
+ sinx-api = sinapsis_cli.main:main_local_api
4
+ sinx-cloud = sinapsis_cli.main:main_cloud
5
+ sinx-venv = sinapsis_cli.main:main_local_venv