DevOps Agent CLI

1#!/usr/bin/env python3
2"""operate-on-aws's telemetry entry: read-only status, or report the Agent Space it created.
3
4    python3 devops_agent_cli.py status
5    python3 devops_agent_cli.py space-created --agent-space-id <id>
6
7The skill runs `space-created` itself, after it has verified the space it created, on
8every host. `status` sends nothing; `needsNotice` is true when no answer is recorded
9or the accepted notice did not name the Agent Space ID.
10"""
11
12import json
13import sys
14from pathlib import Path
15
16TELEMETRY = Path(__file__).resolve().parent
17sys.path[:0] = [str(TELEMETRY / "consent"), str(TELEMETRY / "metric_emission")]
18
19
20def main(argv):
21    # Imports can fail when a standalone bundle is incomplete. Keep them inside
22    # the guarded invocation so optional telemetry still exits without blocking.
23    import agent_space
24    import client
25    import record
26
27    if argv == ["status"]:
28        status = record.consent_status()
29        print(json.dumps({
30            "source": client.detect_source(),
31            "consentStatus": status,
32            "needsNotice": status != record.OPT_OUT and not agent_space.consent_covers_agent_space(),
33            "pluginVersion": client.plugin_version(),
34        }))
35        return 0
36    if len(argv) == 3 and argv[:2] == ["space-created", "--agent-space-id"]:
37        agent_space.send_created(argv[2])
38        return 0
39    print("usage: devops_agent_cli.py {status|space-created --agent-space-id <id>}", file=sys.stderr)
40    return 2
41
42
43if __name__ == "__main__":
44    try:
45        sys.exit(main(sys.argv[1:]))
46    except Exception:
47        sys.exit(0)  # telemetry must not block the skill