@usesocial/cli 0.10.2 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @usesocial/cli
 
+## 0.11.0
+
+### Minor Changes
+
+- [#44](https://github.com/usesocial/monorepo/pull/44) [`570db5e`](https://github.com/usesocial/monorepo/commit/570db5e5f6760dc09fe479f70da239f62addd909) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Add LinkedIn company-Page management and a raw proxy escape hatch. New commands: `linkedin page visitors` (Page visitor analytics, metered), `linkedin page invite <user...>` (invite users to follow a Page), and `linkedin proxy` (forward a raw LinkedIn request from stdin). Pages are selected with `--page` or a configured default via `account config page`; `account config account` sets a default connected account.
+
 ## 0.10.2
 
 ### Patch Changes
@@ -28,7 +34,7 @@
     across pages transparently and returns one merged envelope.
   - `--sum-by <fields>` (comma-separated from `platform`, `path`, `method`,
     `day`, `cacheStatus`) aggregates the selected window into
-    `{ …key, calls, credits, errors }` rows sorted by credits descending —
+    `{ …key, calls, usageUSD, errors }` rows sorted by usage descending —
     a one-command answer to "what did my agent spend this week, on what".
   - `createdAt` is always an ISO string, and the declared contract stays
     JSON-Schema-serializable (`social schema --leaves` works).
@@ -52,7 +58,7 @@
 
 - [#34](https://github.com/usesocial/monorepo/pull/34) [`e3fb8a2`](https://github.com/usesocial/monorepo/commit/e3fb8a2d09301494d95115f8409862d392d78fcb) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Schema contracts now declare advisory hazards instead of confirmation gates:
   `confirmation.{required,recommended}` is replaced by `hazard { kind:
-spends_credits | destructive | outbound_write, confirm: "advisory" }` on
+spends_usage | destructive | outbound_write, confirm: "advisory" }` on
   mutating commands (billing portal and connect declare nothing). Non-TTY
   `account login` and `account connect` become pollable state machines that
   advance one step per call — `pending_approval { verificationURL, expiresAt }`
@@ -171,9 +177,9 @@ spends_credits | destructive | outbound_write, confirm: "advisory" }` on
     `quote_tweet_id`, `made_with_ai`, community, geo, nullcast) are restored for
     `post`.
 
-  Uploading media is free; each finalized file costs a flat 15 credits at the
+  Uploading media is free; each finalized file costs a flat $0.015 usage at the
   finalize step, independent of file size, on top of the normal post-create
-  credits.
+  usage.
 
   Posting media requires the `media.write` OAuth scope. Existing connected X
   accounts must run `social account reconnect x <account>` to gain it — OAuth
@@ -214,8 +220,8 @@ spends_credits | destructive | outbound_write, confirm: "advisory" }` on
     fires if a page arrives missing expected fields, so silent starvation
     cannot recur.
   - Checkpointed `x sync messages` refreshes request small pages instead of
-    full 100-event pages, cutting a caught-up refresh from ~1,470 to ~150
-    credits. `stoppedReason: "checkpoint"` now carries a note explaining it
+    full 100-event pages, cutting a caught-up refresh from ~$1.470 to ~$0.150
+    usage. `stoppedReason: "checkpoint"` now carries a note explaining it
     means "caught up: no new events since the last sync checkpoint".
 
 ## 0.8.0
@@ -259,7 +265,7 @@ spends_credits | destructive | outbound_write, confirm: "advisory" }` on
 
 - [#31](https://github.com/usesocial/monorepo/pull/31) [`a885c61`](https://github.com/usesocial/monorepo/commit/a885c619b6c67b1317d3e17d8fceb3e49e48795f) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Remove `--credits` from `social x sync` and `social linkedin sync`. Sync now
   walks until the provider completes, reaches a stored checkpoint, or hits
-  `--since`; JSON summaries keep actual `creditsSpent` telemetry without exposing
+  `--since`; JSON summaries keep actual `usageUSDSpent` telemetry without exposing
   estimate, cap, `credit-limit`, or `partial` fields.
 
   LinkedIn sync also uses offset pagination for full account-level walks where the
@@ -270,9 +276,9 @@ spends_credits | destructive | outbound_write, confirm: "advisory" }` on
 
 ### Minor Changes
 
-- [#30](https://github.com/usesocial/monorepo/pull/30) [`7aefe83`](https://github.com/usesocial/monorepo/commit/7aefe83f716321d7fa10d52be67cb6f96b5474f0) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Per-collection sync with a confirm-by-credits gate, a local profiles mirror, and cache-first enriched reads.
+- [#30](https://github.com/usesocial/monorepo/pull/30) [`7aefe83`](https://github.com/usesocial/monorepo/commit/7aefe83f716321d7fa10d52be67cb6f96b5474f0) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Per-collection sync with a confirm-by-usage gate, a local profiles mirror, and cache-first enriched reads.
 
-  - `social x|linkedin sync <collection>` walks until provider completion, a stored checkpoint, or `--since`; `--credits` is no longer supported, and sync JSON reports actual `creditsSpent` without estimate, cap, `credit-limit`, or `partial` fields.
+  - `social x|linkedin sync <collection>` walks until provider completion, a stored checkpoint, or `--since`; `--credits` is no longer supported, and sync JSON reports actual `usageUSDSpent` without estimate, cap, `credit-limit`, or `partial` fields.
   - New `x_messages` DM collection (flat `/dm_events`) and a DM `includes.users` profile extractor. Syncs mirror participant profiles into the local cache (`x_profiles`/`li_profiles`) with a COALESCE merge so thin sources never clobber richer rows; the server `profiles` corpus merges the same way.
   - `x followers|following|messages` and `linkedin connections|messages|requests` now read from the local cache, enriched with the profiles mirror. They require a first sync; `followers`/`following`/`connections` then auto-refresh only when older than 15 minutes, while `messages` and `requests sent|received` refresh on every read so they always return the latest.
 
@@ -368,7 +374,7 @@ spends_credits | destructive | outbound_write, confirm: "advisory" }` on
   bookmarks, likes, mentions, timeline, lists, and list members.
 
 - [`6a79019`](https://github.com/usesocial/monorepo/commit/6a79019a46e09e63148341ea8b8cf67aec1f4819) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Mark `social x profile` as a cacheable read so repeated profile fetches can be
-  served from cache for zero credits and support `-H/--header` cache controls.
+  served from cache for $0 usage and support `-H/--header` cache controls.
 
 ## 0.2.2
 
@@ -390,7 +396,7 @@ spends_credits | destructive | outbound_write, confirm: "advisory" }` on
 
 ### Patch Changes
 
-- [`83650e6`](https://github.com/usesocial/monorepo/commit/83650e6f77b94d5cd4a3a5ec673164ff103d6573) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Price every proxy call from the scraped X price list (mirrored for LinkedIn) against a single `usage_credits` balance, fixing a 10–40× write overcharge that mapped non-DM writes to the most expensive category. `account usage` and `account logs` now report cost in credits, and repeated X reads served from cache no longer recharge.
+- [`83650e6`](https://github.com/usesocial/monorepo/commit/83650e6f77b94d5cd4a3a5ec673164ff103d6573) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Price every proxy call from the scraped X price list (mirrored for LinkedIn) against a single `usage_credits` balance, fixing a 10–40× write overcharge that mapped non-DM writes to the most expensive category. `account usage` and `account logs` now report cost in usage dollars, and repeated X reads served from cache no longer recharge.
 
 - [`df52bf7`](https://github.com/usesocial/monorepo/commit/df52bf795e39c333d25b0618cedc047ad6f14b24) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Limit `--no-cache` to generated commands backed by cacheable proxy reads so non-cacheable DM, message, timeline, bookmark, and write commands no longer send misleading cache-control headers.
 

package/README.md

@@ -95,9 +95,9 @@ use SQL `LIMIT` and `ORDER BY`.
 
 ### Your data is local
 
-`sync` pulls your own data down; it is explicit and costs credits. `sql` queries
+`sync` pulls your own data down; it is explicit and costs usage. `sql` queries
 that local mirror; it is free, instant, and read-only. Named read commands call
-the live network and cost credits; `x tweets <target>` and
+the live network and cost usage; `x tweets <target>` and
 `linkedin posts <target>` require a target. Writes act.
 
 `sync` output is always `{ data, meta }`: bare `sync` lists collections under
@@ -150,7 +150,7 @@ profile lookup is needed.
 | `disconnect x <account>` | Disconnect an X account. | write |
 | `billing` | Show seats, subscription, and current usage billing. | |
 | `billing portal` | Open the hosted billing portal and print its URL. | |
-| `usage` | Aggregate proxy calls and credits. | |
+| `usage` | Aggregate proxy calls and usage. | |
 | `logs` | Recent proxy calls. | |
 | `config account` | Read or set the default connected account selector. | local |
 | `config page` | Read or set the default LinkedIn company Page selector. | local |
@@ -164,14 +164,14 @@ profile lookup is needed.
 | `posts <target>` | Live posts for a person or company; target required. | |
 | `comments <target>` | List a post's comments. | |
 | `reactions <target>` | List a post's reactions. | |
-| `connections [target]` | Live connection graph read; omit target for your own account. Costs credits. | |
+| `connections [target]` | Live connection graph read; omit target for your own account. Costs usage. | |
 | `company <target>` | Fetch a company profile. | |
 | `jobs <target>` | List a company's job postings. | |
 | `search people\|posts\|jobs\|companies <keywords>` | Search LinkedIn. | |
-| `page visitors` | Read company Page visitor analytics; pass `--page` or configure a default Page. Costs credits. | |
+| `page visitors` | Read company Page visitor analytics; pass `--page` or configure a default Page. Costs usage. | |
 | `page invite <user...>` | Invite one or more users to follow the company Page selected by `--page` or default config. | write |
 | `proxy` | Forward a raw LinkedIn JSON envelope from stdin via Unipile. | write |
-| `sync [collection]` | Pull your own `connections`, `posts`, `messages`, or `requests` into the local mirror; costs credits. | local |
+| `sync [collection]` | Pull your own `connections`, `posts`, `messages`, or `requests` into the local mirror; costs usage. | local |
 | `sql [query]` | Query your local mirror with read-only SQL - free; bare `sql` prints compact schema metadata. | |
 | `post` | Create a post (body from stdin). | write |
 | `comment <target>` | Comment on a post (body from stdin). | write |
@@ -193,14 +193,14 @@ profile lookup is needed.
 | `tweets <target>` | Live posts for a user; target required. | |
 | `mentions [target]` | List posts mentioning a user; omit target for your own account. | |
 | `liked [target]` | List posts a user liked; omit target for your own account. | |
-| `followers [target]` | Live follower graph read; omit target for your own account. Costs credits. | |
-| `following [target]` | Live following graph read; omit target for your own account. Costs credits. | |
+| `followers [target]` | Live follower graph read; omit target for your own account. Costs usage. | |
+| `following [target]` | Live following graph read; omit target for your own account. Costs usage. | |
 | `tweet <target>` | Fetch a single post. | |
 | `replies <target>` | List replies to a post; accepts `post_id:<id>`, `conversation_id:<id>`, or a post URL. | |
 | `quotes <target>` | List quote posts of a post. | |
 | `likers <target>` | List users who liked a post. | |
 | `reposters <target>` | List users who reposted a post. | |
-| `sync [collection]` | Pull your own `tweets`, `timeline`, `followers`, `following`, `bookmarks`, `liked`, `mentions`, or `messages` into the local mirror; costs credits. | local |
+| `sync [collection]` | Pull your own `tweets`, `timeline`, `followers`, `following`, `bookmarks`, `liked`, `mentions`, or `messages` into the local mirror; costs usage. | local |
 | `sql [query]` | Query your local mirror with read-only SQL - free; bare `sql` prints compact schema metadata. | |
 | `post` | Create a post (body from stdin). | write |
 | `message <recipients>` | Send a DM (body from stdin). | write |
@@ -253,7 +253,8 @@ jq -r '.items[].id' /tmp/recent-posts.json \
 grant, sends a magic link, waits for browser approval, stores the returned token
 in your OS keyring, and confirms billing checkout when a seat is needed.
 
-`social account logout` revokes the session and removes the stored token.
+Sessions last two years unless revoked. `social account logout` revokes the
+session and removes the stored token.
 `social account login` requires an interactive terminal and is not supported from
 CI, background jobs, or agent-mediated setup flows.
 
@@ -338,7 +339,7 @@ social account billing
 social account billing portal
 social account usage
 social account logs --limit 20 --from 2026-05-01T00:00:00Z \
-  | jq -r '.items[] | [.createdAt, .platform, .method, .path, .responseStatus, .cacheStatus, .credits] | @tsv'
+  | jq -r '.items[] | [.createdAt, .platform, .method, .path, .responseStatus, .cacheStatus, .usageUSD] | @tsv'
 
 # Command schema.
 social schema