@trillboards/cli 0.1.0 → 0.1.1

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @trillboards/cli
 $ trillboards COMMAND
 running command...
 $ trillboards (--version)
-@trillboards/cli/0.1.0 darwin-arm64 node-v22.22.0
+@trillboards/cli/0.1.1 darwin-arm64 node-v22.22.0
 $ trillboards --help [COMMAND]
 USAGE
   $ trillboards COMMAND
@@ -29,12 +29,18 @@ USAGE
 <!-- usagestop -->
 # Commands
 <!-- commands -->
+* [`trillboards ads disable`](#trillboards-ads-disable)
+* [`trillboards ads enable`](#trillboards-ads-enable)
+* [`trillboards ads login`](#trillboards-ads-login)
+* [`trillboards ads start`](#trillboards-ads-start)
 * [`trillboards api METHOD PATH`](#trillboards-api-method-path)
 * [`trillboards audience live SCREEN_ID`](#trillboards-audience-live-screen_id)
 * [`trillboards autocomplete [SHELL]`](#trillboards-autocomplete-shell)
 * [`trillboards billing`](#trillboards-billing)
 * [`trillboards billing usage`](#trillboards-billing-usage)
+* [`trillboards code`](#trillboards-code)
 * [`trillboards debug SCREEN_ID`](#trillboards-debug-screen_id)
+* [`trillboards devices reconcile FILE`](#trillboards-devices-reconcile-file)
 * [`trillboards doctor`](#trillboards-doctor)
 * [`trillboards earnings [MODE]`](#trillboards-earnings-mode)
 * [`trillboards endpoints`](#trillboards-endpoints)
@@ -51,9 +57,16 @@ USAGE
 * [`trillboards generated generated-data-api-stats`](#trillboards-generated-generated-data-api-stats)
 * [`trillboards generated generated-data-api-stream`](#trillboards-generated-generated-data-api-stream)
 * [`trillboards generated generated-data-api-usage`](#trillboards-generated-generated-data-api-usage)
+* [`trillboards generated generated-device-heartbeat-get DEVICEID`](#trillboards-generated-generated-device-heartbeat-get-deviceid)
 * [`trillboards generated generated-device-ota-manifest`](#trillboards-generated-generated-device-ota-manifest)
 * [`trillboards generated generated-example-healthcheck`](#trillboards-generated-generated-example-healthcheck)
+* [`trillboards generated generated-federated-get-latest-model-descriptor MODELTYPE`](#trillboards-generated-generated-federated-get-latest-model-descriptor-modeltype)
+* [`trillboards generated generated-federated-get-model-weights MODELTYPE`](#trillboards-generated-generated-federated-get-model-weights-modeltype)
+* [`trillboards generated generated-federated-gradient-upload`](#trillboards-generated-generated-federated-gradient-upload)
+* [`trillboards generated generated-federated-performance-upload`](#trillboards-generated-generated-federated-performance-upload)
+* [`trillboards generated generated-federated-taste-upload`](#trillboards-generated-generated-federated-taste-upload)
 * [`trillboards generated generated-playground-dry-run OPERATION_ID`](#trillboards-generated-generated-playground-dry-run-operation_id)
+* [`trillboards generated generated-post-device-heartbeat DEVICEID`](#trillboards-generated-generated-post-device-heartbeat-deviceid)
 * [`trillboards generated generated-request-metadata-get REQUEST_ID`](#trillboards-generated-generated-request-metadata-get-request_id)
 * [`trillboards generated generated-sdk-enrich`](#trillboards-generated-generated-sdk-enrich)
 * [`trillboards generated generated-sdk-impression`](#trillboards-generated-generated-sdk-impression)
@@ -74,6 +87,114 @@ USAGE
 * [`trillboards validate FILE`](#trillboards-validate-file)
 * [`trillboards whoami`](#trillboards-whoami)
 
+## `trillboards ads disable`
+
+Turn off the in-place sponsored lines (removes the Claude Code dead-time hook).
+
+```
+USAGE
+  $ trillboards ads disable [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+
+DESCRIPTION
+  Turn off the in-place sponsored lines (removes the Claude Code dead-time hook).
+
+EXAMPLES
+  $ trillboards ads disable
+```
+
+_See code: [src/commands/ads/disable.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/ads/disable.ts)_
+
+## `trillboards ads enable`
+
+Turn on in-place sponsored lines in Claude Code (installs the dead-time hook). Opt-in; undo with `ads disable`.
+
+```
+USAGE
+  $ trillboards ads enable [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+
+DESCRIPTION
+  Turn on in-place sponsored lines in Claude Code (installs the dead-time hook). Opt-in; undo with `ads disable`.
+
+EXAMPLES
+  $ trillboards ads enable
+```
+
+_See code: [src/commands/ads/enable.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/ads/enable.ts)_
+
+## `trillboards ads login`
+
+Log in to the agent-ads program with your Trillboards account (email + password)
+
+```
+USAGE
+  $ trillboards ads login [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--email <value>]
+    [--password <value>]
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --email=<value>     Account email (prompts if omitted)
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+  --password=<value>  Account password (prompts hidden if omitted; avoid passing on the command line)
+
+DESCRIPTION
+  Log in to the agent-ads program with your Trillboards account (email + password)
+
+EXAMPLES
+  $ trillboards ads login
+
+  $ trillboards ads login --email you@example.com
+
+  TRILLBOARDS_USER_TOKEN=<jwt> trillboards ads login
+```
+
+_See code: [src/commands/ads/login.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/ads/login.ts)_
+
+## `trillboards ads start`
+
+Register this machine as a virtual screen and rent its AI-coding-agent dead-time for money
+
+```
+USAGE
+  $ trillboards ads start [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--name <value>]
+    [--once] [--simulate] [--interval <value>]
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+  --interval=<value>  Seconds between dead-time fills in --simulate mode (default 60)
+  --name=<value>      Display name for this virtual screen (defaults to "Claude Code on <hostname>")
+  --once              Register, heartbeat once, serve a single ad, then exit (great for testing)
+  --simulate          Treat each interval tick as a dead-time trigger (v0 stand-in for real detection)
+
+DESCRIPTION
+  Register this machine as a virtual screen and rent its AI-coding-agent dead-time for money
+
+EXAMPLES
+  $ trillboards ads start
+
+  $ trillboards ads start --once
+
+  $ trillboards ads start --simulate --interval 30
+```
+
+_See code: [src/commands/ads/start.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/ads/start.ts)_
+
 ## `trillboards api METHOD PATH`
 
 Make raw API requests (like gh api)
@@ -106,7 +227,7 @@ EXAMPLES
   $ trillboards api GET /v1/partner/info --jq partner_name
 ```
 
-_See code: [src/commands/api.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/api.ts)_
+_See code: [src/commands/api.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/api.ts)_
 
 ## `trillboards audience live SCREEN_ID`
 
@@ -138,7 +259,7 @@ EXAMPLES
   $ trillboards audience live scr_abc123 --interval 3
 ```
 
-_See code: [src/commands/audience/live.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/audience/live.ts)_
+_See code: [src/commands/audience/live.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/audience/live.ts)_
 
 ## `trillboards autocomplete [SHELL]`
 
@@ -194,7 +315,7 @@ EXAMPLES
   $ trillboards billing --format json
 ```
 
-_See code: [src/commands/billing.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/billing.ts)_
+_See code: [src/commands/billing.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/billing.ts)_
 
 ## `trillboards billing usage`
 
@@ -222,7 +343,34 @@ EXAMPLES
   $ trillboards billing usage --format json
 ```
 
-_See code: [src/commands/billing/usage.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/billing/usage.ts)_
+_See code: [src/commands/billing/usage.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/billing/usage.ts)_
+
+## `trillboards code`
+
+Wrap your coding agent and earn from its dead-time (plays text/image/video ads while it thinks)
+
+```
+USAGE
+  $ trillboards code [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+
+DESCRIPTION
+  Wrap your coding agent and earn from its dead-time (plays text/image/video ads while it thinks)
+
+EXAMPLES
+  $ trillboards code
+
+  $ trillboards code claude
+
+  $ trillboards code -- codex --foo
+```
+
+_See code: [src/commands/code.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/code.ts)_
 
 ## `trillboards debug SCREEN_ID`
 
@@ -250,7 +398,36 @@ EXAMPLES
   $ trillboards debug scr_abc123 --format json
 ```
 
-_See code: [src/commands/debug.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/debug.ts)_
+_See code: [src/commands/debug.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/debug.ts)_
+
+## `trillboards devices reconcile FILE`
+
+Reconcile your device fleet — diff your external IDs against what Trillboards has registered (matched / missing / orphan / malformed / duplicate)
+
+```
+USAGE
+  $ trillboards devices reconcile FILE [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
+
+ARGUMENTS
+  FILE  Path to your device external IDs — a JSON array, {"external_ids":[...]}, or one ID per line
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+
+DESCRIPTION
+  Reconcile your device fleet — diff your external IDs against what Trillboards has registered (matched / missing /
+  orphan / malformed / duplicate)
+
+EXAMPLES
+  $ trillboards devices reconcile my-devices.json
+
+  $ trillboards devices reconcile ids.txt --format json
+```
+
+_See code: [src/commands/devices/reconcile.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/devices/reconcile.ts)_
 
 ## `trillboards doctor`
 
@@ -273,7 +450,7 @@ EXAMPLES
   $ trillboards doctor
 ```
 
-_See code: [src/commands/doctor.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/doctor.ts)_
+_See code: [src/commands/doctor.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/doctor.ts)_
 
 ## `trillboards earnings [MODE]`
 
@@ -307,7 +484,7 @@ EXAMPLES
   $ trillboards earnings --format json
 ```
 
-_See code: [src/commands/earnings.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/earnings.ts)_
+_See code: [src/commands/earnings.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/earnings.ts)_
 
 ## `trillboards endpoints`
 
@@ -335,7 +512,7 @@ EXAMPLES
   $ trillboards endpoints --format json
 ```
 
-_See code: [src/commands/endpoints/index.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/endpoints/index.ts)_
+_See code: [src/commands/endpoints/index.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/endpoints/index.ts)_
 
 ## `trillboards errors [CODE]`
 
@@ -365,7 +542,7 @@ EXAMPLES
   $ trillboards errors --format json
 ```
 
-_See code: [src/commands/errors/index.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/errors/index.ts)_
+_See code: [src/commands/errors/index.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/errors/index.ts)_
 
 ## `trillboards fill-rate`
 
@@ -397,7 +574,7 @@ EXAMPLES
   $ trillboards fill-rate --format json
 ```
 
-_See code: [src/commands/fill-rate.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/fill-rate.ts)_
+_See code: [src/commands/fill-rate.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/fill-rate.ts)_
 
 ## `trillboards generated generated-changelog-query`
 
@@ -424,7 +601,7 @@ EXAMPLES
   $ trillboards generated changelog query
 ```
 
-_See code: [src/commands/generated/generated-changelog-query.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-changelog-query.ts)_
+_See code: [src/commands/generated/generated-changelog-query.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-changelog-query.ts)_
 
 ## `trillboards generated generated-data-api-aggregate`
 
@@ -451,7 +628,7 @@ EXAMPLES
   $ trillboards generated data-api-aggregate
 ```
 
-_See code: [src/commands/generated/generated-data-api-aggregate.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-data-api-aggregate.ts)_
+_See code: [src/commands/generated/generated-data-api-aggregate.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-data-api-aggregate.ts)_
 
 ## `trillboards generated generated-data-api-list-screens`
 
@@ -479,7 +656,7 @@ EXAMPLES
   $ trillboards generated data-api-list-screens
 ```
 
-_See code: [src/commands/generated/generated-data-api-list-screens.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-data-api-list-screens.ts)_
+_See code: [src/commands/generated/generated-data-api-list-screens.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-data-api-list-screens.ts)_
 
 ## `trillboards generated generated-data-api-lookalike-screens`
 
@@ -506,7 +683,7 @@ EXAMPLES
   $ trillboards generated data-api-lookalike-screens
 ```
 
-_See code: [src/commands/generated/generated-data-api-lookalike-screens.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-data-api-lookalike-screens.ts)_
+_See code: [src/commands/generated/generated-data-api-lookalike-screens.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-data-api-lookalike-screens.ts)_
 
 ## `trillboards generated generated-data-api-query-dsl`
 
@@ -531,7 +708,7 @@ EXAMPLES
   $ trillboards generated data-api-query-dsl
 ```
 
-_See code: [src/commands/generated/generated-data-api-query-dsl.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-data-api-query-dsl.ts)_
+_See code: [src/commands/generated/generated-data-api-query-dsl.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-data-api-query-dsl.ts)_
 
 ## `trillboards generated generated-data-api-screen-audience-history SCREENID`
 
@@ -561,7 +738,7 @@ EXAMPLES
   $ trillboards generated data-api-screen-audience-history
 ```
 
-_See code: [src/commands/generated/generated-data-api-screen-audience-history.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-data-api-screen-audience-history.ts)_
+_See code: [src/commands/generated/generated-data-api-screen-audience-history.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-data-api-screen-audience-history.ts)_
 
 ## `trillboards generated generated-data-api-screen-audience-live SCREENID`
 
@@ -588,7 +765,7 @@ EXAMPLES
   $ trillboards generated data-api-screen-audience-live
 ```
 
-_See code: [src/commands/generated/generated-data-api-screen-audience-live.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-data-api-screen-audience-live.ts)_
+_See code: [src/commands/generated/generated-data-api-screen-audience-live.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-data-api-screen-audience-live.ts)_
 
 ## `trillboards generated generated-data-api-semantic-search`
 
@@ -616,7 +793,7 @@ EXAMPLES
   $ trillboards generated data-api-semantic-search
 ```
 
-_See code: [src/commands/generated/generated-data-api-semantic-search.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-data-api-semantic-search.ts)_
+_See code: [src/commands/generated/generated-data-api-semantic-search.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-data-api-semantic-search.ts)_
 
 ## `trillboards generated generated-data-api-stats`
 
@@ -639,7 +816,7 @@ EXAMPLES
   $ trillboards generated data-api-stats
 ```
 
-_See code: [src/commands/generated/generated-data-api-stats.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-data-api-stats.ts)_
+_See code: [src/commands/generated/generated-data-api-stats.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-data-api-stats.ts)_
 
 ## `trillboards generated generated-data-api-stream`
 
@@ -665,7 +842,7 @@ EXAMPLES
   $ trillboards generated data-api-stream
 ```
 
-_See code: [src/commands/generated/generated-data-api-stream.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-data-api-stream.ts)_
+_See code: [src/commands/generated/generated-data-api-stream.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-data-api-stream.ts)_
 
 ## `trillboards generated generated-data-api-usage`
 
@@ -690,7 +867,34 @@ EXAMPLES
   $ trillboards generated data-api-usage
 ```
 
-_See code: [src/commands/generated/generated-data-api-usage.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-data-api-usage.ts)_
+_See code: [src/commands/generated/generated-data-api-usage.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-data-api-usage.ts)_
+
+## `trillboards generated generated-device-heartbeat-get DEVICEID`
+
+Read live device heartbeat state.
+
+```
+USAGE
+  $ trillboards generated generated-device-heartbeat-get DEVICEID [--api-key <value>] [--base-url <value>] [--format
+  json|table|yaml]
+
+ARGUMENTS
+  DEVICEID  Device fingerprint or external device ID.
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+
+DESCRIPTION
+  Read live device heartbeat state.
+
+EXAMPLES
+  $ trillboards generated device-heartbeat get
+```
+
+_See code: [src/commands/generated/generated-device-heartbeat-get.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-device-heartbeat-get.ts)_
 
 ## `trillboards generated generated-device-ota-manifest`
 
@@ -716,7 +920,7 @@ EXAMPLES
   $ trillboards generated device-ota-manifest
 ```
 
-_See code: [src/commands/generated/generated-device-ota-manifest.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-device-ota-manifest.ts)_
+_See code: [src/commands/generated/generated-device-ota-manifest.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-device-ota-manifest.ts)_
 
 ## `trillboards generated generated-example-healthcheck`
 
@@ -741,7 +945,146 @@ EXAMPLES
   $ trillboards generated example-healthcheck
 ```
 
-_See code: [src/commands/generated/generated-example-healthcheck.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-example-healthcheck.ts)_
+_See code: [src/commands/generated/generated-example-healthcheck.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-example-healthcheck.ts)_
+
+## `trillboards generated generated-federated-get-latest-model-descriptor MODELTYPE`
+
+Fetch the latest aggregated model descriptor (download URL + sha256 + version).
+
+```
+USAGE
+  $ trillboards generated generated-federated-get-latest-model-descriptor MODELTYPE [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
+    [--venue_type <value>] [--venue_subtype <value>] [--daypart <value>] [--geo <value>] [--device_profile <value>]
+
+ARGUMENTS
+  MODELTYPE  Federated model name.
+
+FLAGS
+  --api-key=<value>         [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>        [default: https://api.trillboards.com] API base URL
+  --daypart=<value>         daypart
+  --device_profile=<value>  device_profile
+  --format=<option>         Output format
+                            <options: json|table|yaml>
+  --geo=<value>             geo
+  --venue_subtype=<value>   venue_subtype
+  --venue_type=<value>      Venue category (required).
+
+DESCRIPTION
+  Fetch the latest aggregated model descriptor (download URL + sha256 + version).
+
+EXAMPLES
+  $ trillboards generated federated-get-latest-model-descriptor
+```
+
+_See code: [src/commands/generated/generated-federated-get-latest-model-descriptor.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-federated-get-latest-model-descriptor.ts)_
+
+## `trillboards generated generated-federated-get-model-weights MODELTYPE`
+
+Fetch aggregated weights for the device-specific slice.
+
+```
+USAGE
+  $ trillboards generated generated-federated-get-model-weights MODELTYPE [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
+    [--venue_type <value>] [--venue_subtype <value>] [--daypart <value>] [--geo <value>] [--device_profile <value>]
+
+ARGUMENTS
+  MODELTYPE  Federated model name.
+
+FLAGS
+  --api-key=<value>         [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>        [default: https://api.trillboards.com] API base URL
+  --daypart=<value>         daypart
+  --device_profile=<value>  device_profile
+  --format=<option>         Output format
+                            <options: json|table|yaml>
+  --geo=<value>             geo
+  --venue_subtype=<value>   venue_subtype
+  --venue_type=<value>      Venue category for slice lookup. Snake_case query alias of venueType.
+
+DESCRIPTION
+  Fetch aggregated weights for the device-specific slice.
+
+EXAMPLES
+  $ trillboards generated federated-get-model-weights
+```
+
+_See code: [src/commands/generated/generated-federated-get-model-weights.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-federated-get-model-weights.ts)_
+
+## `trillboards generated generated-federated-gradient-upload`
+
+Upload sparsified gradients for multi-slice federated aggregation.
+
+```
+USAGE
+  $ trillboards generated generated-federated-gradient-upload [--api-key <value>] [--base-url <value>] [--format
+  json|table|yaml] [--data <value>]
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --data=<value>      JSON request body
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+
+DESCRIPTION
+  Upload sparsified gradients for multi-slice federated aggregation.
+
+EXAMPLES
+  $ trillboards generated federated-gradient-upload
+```
+
+_See code: [src/commands/generated/generated-federated-gradient-upload.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-federated-gradient-upload.ts)_
+
+## `trillboards generated generated-federated-performance-upload`
+
+Report on-device model performance metrics.
+
+```
+USAGE
+  $ trillboards generated generated-federated-performance-upload [--api-key <value>] [--base-url <value>] [--format
+  json|table|yaml] [--data <value>]
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --data=<value>      JSON request body
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+
+DESCRIPTION
+  Report on-device model performance metrics.
+
+EXAMPLES
+  $ trillboards generated federated-performance-upload
+```
+
+_See code: [src/commands/generated/generated-federated-performance-upload.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-federated-performance-upload.ts)_
+
+## `trillboards generated generated-federated-taste-upload`
+
+Upload a screen-taste embedding for content personalization aggregation.
+
+```
+USAGE
+  $ trillboards generated generated-federated-taste-upload [--api-key <value>] [--base-url <value>] [--format
+  json|table|yaml] [--data <value>]
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --data=<value>      JSON request body
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+
+DESCRIPTION
+  Upload a screen-taste embedding for content personalization aggregation.
+
+EXAMPLES
+  $ trillboards generated federated-taste-upload
+```
+
+_See code: [src/commands/generated/generated-federated-taste-upload.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-federated-taste-upload.ts)_
 
 ## `trillboards generated generated-playground-dry-run OPERATION_ID`
 
@@ -768,7 +1111,35 @@ EXAMPLES
   $ trillboards generated playground-dry-run
 ```
 
-_See code: [src/commands/generated/generated-playground-dry-run.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-playground-dry-run.ts)_
+_See code: [src/commands/generated/generated-playground-dry-run.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-playground-dry-run.ts)_
+
+## `trillboards generated generated-post-device-heartbeat DEVICEID`
+
+Submit a device heartbeat.
+
+```
+USAGE
+  $ trillboards generated generated-post-device-heartbeat DEVICEID [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--data
+    <value>]
+
+ARGUMENTS
+  DEVICEID  Device fingerprint or external device ID.
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --data=<value>      JSON request body
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+
+DESCRIPTION
+  Submit a device heartbeat.
+
+EXAMPLES
+  $ trillboards generated post-device-heartbeat
+```
+
+_See code: [src/commands/generated/generated-post-device-heartbeat.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-post-device-heartbeat.ts)_
 
 ## `trillboards generated generated-request-metadata-get REQUEST_ID`
 
@@ -795,7 +1166,7 @@ EXAMPLES
   $ trillboards generated request-metadata get
 ```
 
-_See code: [src/commands/generated/generated-request-metadata-get.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-request-metadata-get.ts)_
+_See code: [src/commands/generated/generated-request-metadata-get.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-request-metadata-get.ts)_
 
 ## `trillboards generated generated-sdk-enrich`
 
@@ -820,7 +1191,7 @@ EXAMPLES
   $ trillboards generated sdk-enrich
 ```
 
-_See code: [src/commands/generated/generated-sdk-enrich.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-sdk-enrich.ts)_
+_See code: [src/commands/generated/generated-sdk-enrich.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-sdk-enrich.ts)_
 
 ## `trillboards generated generated-sdk-impression`
 
@@ -845,7 +1216,7 @@ EXAMPLES
   $ trillboards generated sdk-impression
 ```
 
-_See code: [src/commands/generated/generated-sdk-impression.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-sdk-impression.ts)_
+_See code: [src/commands/generated/generated-sdk-impression.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-sdk-impression.ts)_
 
 ## `trillboards generated generated-sdk-qr-beacon`
 
@@ -870,7 +1241,7 @@ EXAMPLES
   $ trillboards generated sdk-qr-beacon
 ```
 
-_See code: [src/commands/generated/generated-sdk-qr-beacon.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-sdk-qr-beacon.ts)_
+_See code: [src/commands/generated/generated-sdk-qr-beacon.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-sdk-qr-beacon.ts)_
 
 ## `trillboards generated generated-sdk-qr-scan`
 
@@ -895,7 +1266,7 @@ EXAMPLES
   $ trillboards generated sdk-qr-scan
 ```
 
-_See code: [src/commands/generated/generated-sdk-qr-scan.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-sdk-qr-scan.ts)_
+_See code: [src/commands/generated/generated-sdk-qr-scan.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-sdk-qr-scan.ts)_
 
 ## `trillboards generated generated-sensing-paired-training-upload`
 
@@ -920,7 +1291,7 @@ EXAMPLES
   $ trillboards generated sensing-paired-training-upload
 ```
 
-_See code: [src/commands/generated/generated-sensing-paired-training-upload.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/generated/generated-sensing-paired-training-upload.ts)_
+_See code: [src/commands/generated/generated-sensing-paired-training-upload.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/generated/generated-sensing-paired-training-upload.ts)_
 
 ## `trillboards help [COMMAND]`
 
@@ -973,7 +1344,7 @@ EXAMPLES
   $ trillboards listen 4000 --events request.logged,error.occurred
 ```
 
-_See code: [src/commands/listen.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/listen.ts)_
+_See code: [src/commands/listen.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/listen.ts)_
 
 ## `trillboards login`
 
@@ -998,7 +1369,7 @@ EXAMPLES
   TRILLBOARDS_API_KEY=trb_partner_xxx trillboards login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/login.ts)_
 
 ## `trillboards logs tail`
 
@@ -1030,7 +1401,7 @@ EXAMPLES
   $ trillboards logs tail --events request.logged,error.occurred --status 5xx
 ```
 
-_See code: [src/commands/logs/tail.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/logs/tail.ts)_
+_See code: [src/commands/logs/tail.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/logs/tail.ts)_
 
 ## `trillboards reconcile`
 
@@ -1058,7 +1429,7 @@ EXAMPLES
   $ trillboards reconcile --format json
 ```
 
-_See code: [src/commands/reconcile.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/reconcile.ts)_
+_See code: [src/commands/reconcile.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/reconcile.ts)_
 
 ## `trillboards sandbox create`
 
@@ -1083,7 +1454,7 @@ EXAMPLES
   $ trillboards sandbox create --format json
 ```
 
-_See code: [src/commands/sandbox/create.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/sandbox/create.ts)_
+_See code: [src/commands/sandbox/create.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/sandbox/create.ts)_
 
 ## `trillboards sandbox emit EVENT_TYPE`
 
@@ -1115,7 +1486,7 @@ EXAMPLES
   $ trillboards sandbox emit impression.recorded --data '{"cpm": 3.50}'
 ```
 
-_See code: [src/commands/sandbox/emit.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/sandbox/emit.ts)_
+_See code: [src/commands/sandbox/emit.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/sandbox/emit.ts)_
 
 ## `trillboards sandbox reset`
 
@@ -1140,7 +1511,7 @@ EXAMPLES
   $ trillboards sandbox reset --format json
 ```
 
-_See code: [src/commands/sandbox/reset.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/sandbox/reset.ts)_
+_See code: [src/commands/sandbox/reset.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/sandbox/reset.ts)_
 
 ## `trillboards sandbox status`
 
@@ -1165,7 +1536,7 @@ EXAMPLES
   $ trillboards sandbox status --format json
 ```
 
-_See code: [src/commands/sandbox/status.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/sandbox/status.ts)_
+_See code: [src/commands/sandbox/status.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/sandbox/status.ts)_
 
 ## `trillboards screens watch`
 
@@ -1200,7 +1571,7 @@ EXAMPLES
   $ trillboards screens watch --format json
 ```
 
-_See code: [src/commands/screens/watch.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/screens/watch.ts)_
+_See code: [src/commands/screens/watch.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/screens/watch.ts)_
 
 ## `trillboards trigger [EVENT_TYPE]`
 
@@ -1230,7 +1601,7 @@ EXAMPLES
   $ trillboards trigger impression_complete --format json
 ```
 
-_See code: [src/commands/trigger.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/trigger.ts)_
+_See code: [src/commands/trigger.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/trigger.ts)_
 
 ## `trillboards validate FILE`
 
@@ -1259,7 +1630,7 @@ EXAMPLES
   $ trillboards validate payload.json --operation create_screen
 ```
 
-_See code: [src/commands/validate.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/validate.ts)_
+_See code: [src/commands/validate.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/validate.ts)_
 
 ## `trillboards whoami`
 
@@ -1284,5 +1655,5 @@ EXAMPLES
   $ trillboards whoami --format json
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/trillboards/packages/blob/v0.1.0/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/trillboards/packages/blob/v0.1.1/src/commands/whoami.ts)_
 <!-- commandsstop -->