thoughtleaders-cli 0.9.22__py3-none-any.whl → 0.9.23__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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: thoughtleaders-cli
3
- Version: 0.9.22
3
+ Version: 0.9.23
4
4
  Summary: ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence
5
5
  Project-URL: Homepage, https://thoughtleaders.io
6
6
  Project-URL: Repository, https://github.com/ThoughtLeaders-io/thoughtleaders-cli
@@ -1,4 +1,4 @@
1
- tl_cli/__init__.py,sha256=5HAz7aILtBFKk8rzV-S8W0GWF6ZtuH2pLbcdspC5h14,113
1
+ tl_cli/__init__.py,sha256=O6LBgMbq2lhYDavyT8KJsotoh_iKgHZMOAv7HdT19nA,113
2
2
  tl_cli/__main__.py,sha256=-FCBeOBi5Zi0hhZI3FWRilisl2DHxKeszgkY0r9VLR4,444
3
3
  tl_cli/_completions.py,sha256=kOyEUqC26vbYvyXWi513WX8fF73qQLR5WWuRSe_wqyk,164
4
4
  tl_cli/_typer_utils.py,sha256=ZiZsCVmEznPvBw-dYbr3tu3zWZ0iN6kjoQmK3gMqD28,860
@@ -24,7 +24,7 @@ tl_cli/commands/balance.py,sha256=s5uH0ijahT2gfgOKzOFxYxHyRBq50mT8zpNCY6KEsBY,37
24
24
  tl_cli/commands/brands.py,sha256=uogOfAdEbpjqiGlv4L2T1UC-Iz10G6fkRhVsDBOjRIY,15340
25
25
  tl_cli/commands/bulk_import.py,sha256=d4y1k_lD52LPJcCqXxEmyHIqcIwomZgbjqs1_QxPjeQ,4536
26
26
  tl_cli/commands/changelog.py,sha256=D1PtDdHpawTlWqUHjKzVmv9yXLSU915UVmI3dZzEwyA,4241
27
- tl_cli/commands/channels.py,sha256=gs6jHaxi6WjB3D8jnJETFVvkTXpqzlWR-W4JkBeG3oY,20406
27
+ tl_cli/commands/channels.py,sha256=ib1kTYNr0MjWVEbWLUmONX3-kyj0JLtwLGpTCxHwjHU,20409
28
28
  tl_cli/commands/credits.py,sha256=2xCht2e420LmaFBKNdKoMz8GlTh31qSWSlJAnVzoZic,7308
29
29
  tl_cli/commands/db.py,sha256=RcuGYzmTs5KMk6RgYao3oV-j883dG7IonTQclZg7UZs,9148
30
30
  tl_cli/commands/deals.py,sha256=ZK9yneInsC6DXoCPS65oyLoVR0eRW1xdRlEN7oRp1pc,2174
@@ -47,7 +47,7 @@ tl_cli/commands/workflows.py,sha256=ctduYa--Md6zbs8kQwO6mSyR9o1KB1UpNOaANuupDfU,
47
47
  tl_cli/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
48
48
  tl_cli/output/formatter.py,sha256=itNyHcDfRbksJgJ58JLtwJIrlHjqQj9gmK6uc3d9bSM,25692
49
49
  tl_cli/_plugin/.claude-plugin/marketplace.json,sha256=l56PMmyjfGXNGlV30wRyOAe74B6gJNCVNCxgsBbSNxc,446
50
- tl_cli/_plugin/.claude-plugin/plugin.json,sha256=eGjcDKuqbkjQUPkGQdEBaPpnQIAmjbdF5eua4qrRdBI,467
50
+ tl_cli/_plugin/.claude-plugin/plugin.json,sha256=ZhfSI025MJDNUQcVNaUeD2zKCTKiqubs2uaYwbNBxE8,467
51
51
  tl_cli/_plugin/agents/cast-sheet.md,sha256=0owR8XIjR4tbKuK4t3WruiJAjGQ8se2cnOGwzigs4Lk,1224
52
52
  tl_cli/_plugin/agents/gem-classifier.md,sha256=s9kkbhUc-JhJ_be9z6LNaojykQSV16zrOd-QVaKNwxc,1250
53
53
  tl_cli/_plugin/agents/keyword-context-classifier.md,sha256=8Pk6WqJKuF-ERkBh54Aa-9t60CvjdOIH0RurFlG-T7I,4325
@@ -65,11 +65,11 @@ tl_cli/_plugin/skills/connector-impact/SKILL.md,sha256=K4mozNpRSLjTSICRTX8LihnKI
65
65
  tl_cli/_plugin/skills/connector-impact/references/help.md,sha256=Wd8X35OwYAswj-xoFZPnCWctwFIx9EXNZ511FDB2I5c,5831
66
66
  tl_cli/_plugin/skills/connector-impact/references/impact-schema.md,sha256=dlAtA6OwkqgXojaItnaQBEIXVxLoVuavuWsPtQ4Rc_0,10155
67
67
  tl_cli/_plugin/skills/connector-impact/references/impact-to-tl-mapping.md,sha256=58IJ5r1I0aEmIETFm81vMAbd1NxVMol8-fqqvHG3qXY,22122
68
- tl_cli/_plugin/skills/tl/SKILL.md,sha256=cYEGvIrjrKtBGsduwL3uuWkOdjFB6kW5iEzy1AMgnhE,72751
69
- tl_cli/_plugin/skills/tl/references/business-glossary.md,sha256=lNTHfo9zm7l_KAQB4libEVfpF-qZj7DXBlzKUo_uqkk,20208
68
+ tl_cli/_plugin/skills/tl/SKILL.md,sha256=C9XAkgeQUB-Or8-CSbZPVwoh9JS184bK0gj1y7nNiJ8,72757
69
+ tl_cli/_plugin/skills/tl/references/business-glossary.md,sha256=DkM-3DGnI_Dvr8fsB9B00-5erXv9r94umFCMVBGOxEs,20214
70
70
  tl_cli/_plugin/skills/tl/references/elasticsearch-schema.md,sha256=zjuHmJRooTTZvu2GfoQxG8xmRcExcKa33K1jipLAShI,25222
71
71
  tl_cli/_plugin/skills/tl/references/firebolt-schema.md,sha256=yf_elP_qXQePtMJNMshoVUOrI_3CXezF0NOoiYTbMNU,11335
72
- tl_cli/_plugin/skills/tl/references/postgres-schema.md,sha256=ardgaLIYTPD2HxNxTJP5AzN8tYUq5Ocu2sdit5JsBq0,30405
72
+ tl_cli/_plugin/skills/tl/references/postgres-schema.md,sha256=q0f264d1KhE96IwmVp7u-GX2N3tlanUiSIIPlqemIfo,30614
73
73
  tl_cli/_plugin/skills/tl-brand-creator-connection/SKILL.md,sha256=6__d4Z1_Mdb8m9nMKxU2wAYxAfu_3o_ucqn-0nXzqJs,35615
74
74
  tl_cli/_plugin/skills/tl-brand-creator-connection/references/cast-sheet.md,sha256=Y1Yj0D36tTGldn6uILoDOYwdMyjAp1oT9P-nUNgSyLg,4393
75
75
  tl_cli/_plugin/skills/tl-brand-creator-connection/references/creator-brief-template.md,sha256=mtFNSCPfj2fGrKtMX2g-Q1UNHYs59H4fARz320EutJA,10901
@@ -140,7 +140,7 @@ tl_cli/_plugin/skills/tl-save-report/references/columns_sponsorships.md,sha256=I
140
140
  tl_cli/_plugin/skills/tl-save-report/references/intelligence_filterset_schema.json,sha256=M_gUX6qDLUrAEcocYjU6ta6UaQS1kUSZpogCZzdqCTk,18140
141
141
  tl_cli/_plugin/skills/tl-save-report/references/intelligence_widget_schema.json,sha256=cxdlzmkt5WoI20zGsq_4qENTc6Ral9_vI5YTx2yzf-g,11503
142
142
  tl_cli/_plugin/skills/tl-save-report/references/report_glossary.md,sha256=YkUxEkUVui9HVC45BYBoyKVuyc_sLmf2GkSAEksmzW0,12165
143
- tl_cli/_plugin/skills/tl-save-report/references/sortable_columns.json,sha256=4X878VptWmS1ETfKZSXJ3U0E0lOw4JtVXsZTVHTsPUc,7571
143
+ tl_cli/_plugin/skills/tl-save-report/references/sortable_columns.json,sha256=Q8SYRqoMKMvu0r6qMWlSkmGdI_r5_Q9PwWhidqLFPig,7574
144
144
  tl_cli/_plugin/skills/tl-save-report/references/sponsorship_filterset_schema.json,sha256=7bS5G19A6JxOFyx-QoueURBoOf23FxCylwLeqgh8aKk,11381
145
145
  tl_cli/_plugin/skills/tl-save-report/references/sponsorship_widget_schema.json,sha256=PXEhZzRTNl94fFHpsBuo4Gop-Mdveg6GCaIm-ZGhBns,9587
146
146
  tl_cli/_plugin/skills/tl-save-report/references/widgets.md,sha256=LrqRyvZHOXVF15FglkeYh6io7f3cYmZEpH00WhEJWKw,9881
@@ -148,8 +148,8 @@ tl_cli/_plugin/skills/tl-top-partnerships/SKILL.md,sha256=jOMMr40XRnAZv-oRLeyKJT
148
148
  tl_cli/_plugin/skills/tl-top-partnerships/scripts/top_partnerships.py,sha256=OqhoyvFe1zrtrStChcam7oPYgFnSbGHC3WAgLhLIC3w,13738
149
149
  tl_cli/_plugin/skills/tl-views-guarantee/SKILL.md,sha256=IH7q1WJDWri9TWJMiga1FMGJO_GKSbWwaDS6CVNZ9c0,9270
150
150
  tl_cli/_plugin/skills/tl-views-guarantee/scripts/vg.py,sha256=5FucKm0WXa16btyUKMyGpdRQ5euVhzKMSoTonuwlm5I,16444
151
- thoughtleaders_cli-0.9.22.dist-info/METADATA,sha256=jPQ4Ht3HFhQ_7CcEQqEQxveY95gKC9mbdQbIWDmuHEM,22294
152
- thoughtleaders_cli-0.9.22.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
153
- thoughtleaders_cli-0.9.22.dist-info/entry_points.txt,sha256=umZp-1BkGkHDG0bNZXpTXrjwW0HGf9IDFN40eAWuuvg,39
154
- thoughtleaders_cli-0.9.22.dist-info/licenses/LICENSE,sha256=RUfdfLsn6jygiyrnnVUHt6r4IPwr2rbDm9Kixgtu8fo,1071
155
- thoughtleaders_cli-0.9.22.dist-info/RECORD,,
151
+ thoughtleaders_cli-0.9.23.dist-info/METADATA,sha256=_tnnKup-PkJxYilQwLfi9lE7-FQVlB2dugCUa_h14qk,22294
152
+ thoughtleaders_cli-0.9.23.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
153
+ thoughtleaders_cli-0.9.23.dist-info/entry_points.txt,sha256=umZp-1BkGkHDG0bNZXpTXrjwW0HGf9IDFN40eAWuuvg,39
154
+ thoughtleaders_cli-0.9.23.dist-info/licenses/LICENSE,sha256=RUfdfLsn6jygiyrnnVUHt6r4IPwr2rbDm9Kixgtu8fo,1071
155
+ thoughtleaders_cli-0.9.23.dist-info/RECORD,,
tl_cli/__init__.py CHANGED
@@ -1,3 +1,3 @@
1
1
  """ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence."""
2
2
 
3
- __version__ = "0.9.22"
3
+ __version__ = "0.9.23"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tl-cli",
3
- "version": "0.9.22",
3
+ "version": "0.9.23",
4
4
  "description": "ThoughtLeaders CLI — query sponsorship deals, channels, brands, uploads, and intelligence from the terminal",
5
5
  "author": {
6
6
  "name": "ThoughtLeaders",
@@ -95,7 +95,7 @@ Other key concepts:
95
95
  - Org scoping for sponsorships is profile-mediated: a sponsorship belongs to your org if **either** `advertiser_profile.organization` (brand side) **or** the adspot seller's organization — `ad_spot.publisher` → that user's profile → `organization` (publisher side) — matches yours. Representing the channel does not surface its deals.
96
96
  - **MSN** (Media Selling Network) — the ~12k YouTube channels that have opted in to receive sponsorship offers. A channels is in the MSN group if the `channel.media_selling_network_join_date` field is not null.
97
97
  - **MBN** (Media Buying Network) — the brand-side counterpart to MSN: brand profiles that have opted in to receive proposed sponsorships. A profile is in the MBN group if the `profile.media_buying_network_join_date` field is not null.
98
- - **TPP** (ThoughtLeaders Partner Program, a.k.a. "TL channels") — the ~170 channels TL has the closest working relationship with. A channel is in the TPP group if `channel.is_tpp` is True. **Prefer TPP channels when booking**: they respond fastest, are the easiest to close, and don't need an outreach round-trip — treat them as immediately bookable. TPP is a strict subset of MSN, so the same booking rules (one active mention adspot, etc.) apply.
98
+ - **TPP** (ThoughtLeaders Partner Program, a.k.a. "TL channels") — the ~170 channels TL has the closest working relationship with. A channel is in the TPP group if `channel.is_tpp` is True. **Prefer TPP channels when booking**: they respond fastest, are the easiest to close, and don't need an outreach round-trip — treat them as immediately bookable. TPP is a strict subset of MSN, so the same booking rules (one preferred mention adspot, etc.) apply.
99
99
  - **`demographics_updated_at`** (on channels) — If non-null, the channel has demographics screenshots on file. If null, no demographics screenshots have been uploaded. Use this to check whether a channel has demographics data from screenshots.
100
100
  - **`subscribers`** (on channels) — the channel's subscriber count.
101
101
  - **`projected_views`** (on channels) — projected views per video on that channel. Forward-looking estimate. May be null when not yet computed. ⚠️ NOT actual views and NOT ad-industry "impressions" (ads served).
@@ -103,7 +103,7 @@ Other key concepts:
103
103
  - **`views_guarantee`** (on sponsorships) — projected/guaranteed impressions for the sponsorship. Numeric.
104
104
  - **Sponsorship detail fields** (returned by `tl sponsorships show <id> --json`) — the detail payload includes `integration` (raw int), `publish_count`, `common_name`, `outreach_email`, nested `publisher` (`first_name`, `last_name`, `email`), nested `brand_contact` (`first_name`, `last_name`, `email`), and `brand.organization_name`. Use these when generating IOs, contracts, or outreach.
105
105
  - **CPM** has two distinct meanings depending on level — pick the one the user actually wants:
106
- - **Channel CPM** = `(adspot.price / channel.projected_views) * 1000` — projected price per thousand projected views. Used for pricing decisions **before** a sponsorship is sold. Available for channels with active adspots via `tl channels show <channel_id>`.
106
+ - **Channel CPM** = `(adspot.price / channel.projected_views) * 1000` — projected price per thousand projected views. Used for pricing decisions **before** a sponsorship is sold. Available for channels with preferred adspots via `tl channels show <channel_id>`.
107
107
  - **Sponsorship CPM** = calculated in either of two ways: if `views` is present, then CPM is `(sponsorship.price / sponsorship.views) × 1000`, meaning realized cost per thousand actual views, computed post-publication. If `views` is null, Compute from the sponsorship's `price` and the channel's `projected_views` fields.
108
108
  - Where possible, calculate the correct CPM in a SQL expression.
109
109
  - **Sponsorship dates** — each sponsorship has four distinct dates, useful for different queries:
@@ -56,7 +56,7 @@ Maps business terms to database concepts.
56
56
  - A channel can have **multiple ad spots** because different people sell the same channel (talent manager, direct, multiple agencies)
57
57
  - Ad spots are the **catalogue** — adlinks are **instances** of catalogue items
58
58
  - Price/cost on adspot = list/catalog values; price/cost on adlink = actual deal values
59
- - **Only one active adspot with integration=mention per channel at any time** (MSN rule)
59
+ - **Only one preferred adspot with integration=mention per channel at any time** (MSN rule)
60
60
 
61
61
  ## Ownership & Accountability
62
62
 
@@ -79,7 +79,7 @@ Maps business terms to database concepts.
79
79
  - Key data: **who is the contact** to buy the ad from
80
80
  - `thoughtleaders_channel.media_selling_network_join_date` = when channel joined MSN
81
81
  - `thoughtleaders_channel.is_tpp` = TPP channel — TL's closest partners, a strict subset of MSN. **Prefer when booking**: fastest response, easiest to close. Not a gating flag; not a process barrier.
82
- - **Rule:** Only one active adspot with `integration=mention` per channel at any time
82
+ - **Rule:** Only one preferred adspot with `integration=mention` per channel at any time
83
83
  - MSN quality depends on having current, accurate contact info
84
84
 
85
85
  ## Channels & Audience
@@ -165,8 +165,9 @@ A channel can have multiple adspots (different sellers: talent manager, direct,
165
165
  | `channel_id` | int FK | → `thoughtleaders_channel.id` |
166
166
  | `price` | numeric | List/catalogue price |
167
167
  | `cost` | numeric | List/catalogue cost |
168
- | `integration` | int | 1=YouTube Mentions (live reads). Only one active mention-type adspot per channel. |
169
- | `is_active` | boolean | Active flag |
168
+ | `integration` | int | 1=YouTube Mentions (live reads). Only one preferred mention-type adspot per channel. |
169
+ | `is_preferred` | boolean | The channel's preferred spot, the one new proposals are booked on |
170
+ | `is_active` | boolean | False = deactivated, unusable, kept only for its AdLinks. Client sandboxes never show deactivated spots or their AdLinks |
170
171
  | `publisher_id` | int FK | → `auth_user.id` (NOT `thoughtleaders_profile.id` — see gotcha below) |
171
172
 
172
173
  ### Key columns for the `thoughtleaders_channel` table
@@ -41,7 +41,7 @@
41
41
  {"name": "Avg. Comments", "backend_code": "comments_avg", "sortability": "both", "description": "Average comments per YouTube video."},
42
42
  {"name": "Median Evergreenness", "backend_code": "evergreenness_median", "sortability": "both", "description": "Median evergreenness for the channel."},
43
43
  {"name": "Avg. Evergreenness", "backend_code": "evergreenness_avg", "sortability": "both", "description": "Average evergreenness for the channel."},
44
- {"name": "Latest AdSpot Price", "backend_code": "latest_adspot_price", "sortability": "both", "description": "Price from the latest active AdSpot."},
44
+ {"name": "Latest AdSpot Price", "backend_code": "latest_adspot_price", "sortability": "both", "description": "Price from the latest preferred AdSpot."},
45
45
  {"name": "Subscribers", "backend_code": "subscribers", "sortability": "both", "description": "Channel subscriber count."},
46
46
  {"name": "Projected Views", "backend_code": "projected_views", "sortability": "both", "description": "Projected views for the channel's next video."},
47
47
  {"name": "Trend", "backend_code": "trend", "sortability": "both", "description": "Growth trend score — higher means faster-growing channel."}
@@ -71,7 +71,7 @@ def show_cmd(
71
71
  csv_output: bool = typer.Option(False, "--csv", help="CSV output (flattens adspots: one row per adspot)"),
72
72
  toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
73
73
  ) -> None:
74
- """Show channel detail by ID or name (includes active adspots).
74
+ """Show channel detail by ID or name (includes preferred adspots).
75
75
 
76
76
  Accepts either a numeric channel ID or a partial name. Names that
77
77
  match more than one active channel return a 400 with the candidate