@sortlist/cli 0.61.0 → 0.63.0
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.
- package/dist/chunk-MOYY5PLS.js +996 -0
- package/dist/chunk-MOYY5PLS.js.map +1 -0
- package/dist/core.d.ts +208 -0
- package/dist/core.js +39 -0
- package/dist/core.js.map +1 -0
- package/dist/index.js +210 -825
- package/dist/index.js.map +1 -1
- package/package.json +14 -1
- package/skills/sortlist-cli/references/billing-and-permissions.md +22 -39
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sortlist/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.63.0",
|
|
4
4
|
"description": "Sortlist platform CLI — GraphQL federation client",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -16,6 +16,19 @@
|
|
|
16
16
|
"bin": {
|
|
17
17
|
"sl": "bin/sl.mjs"
|
|
18
18
|
},
|
|
19
|
+
"exports": {
|
|
20
|
+
".": {
|
|
21
|
+
"types": "./dist/core.d.ts",
|
|
22
|
+
"import": "./dist/core.js",
|
|
23
|
+
"default": "./dist/core.js"
|
|
24
|
+
},
|
|
25
|
+
"./core": {
|
|
26
|
+
"types": "./dist/core.d.ts",
|
|
27
|
+
"import": "./dist/core.js",
|
|
28
|
+
"default": "./dist/core.js"
|
|
29
|
+
},
|
|
30
|
+
"./package.json": "./package.json"
|
|
31
|
+
},
|
|
19
32
|
"files": [
|
|
20
33
|
"bin/",
|
|
21
34
|
"dist/",
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Billing, approval and spend reports
|
|
2
2
|
|
|
3
3
|
Read before a quote, paid data reveal, watcher, Outreach action or subscription change. Keep the
|
|
4
|
-
requested output, caller and payer explicit. Prices come from the
|
|
5
|
-
|
|
4
|
+
requested output, caller and payer explicit. Prices come from the live price list
|
|
5
|
+
(see [Prices](#prices)), never from memory or an old quote.
|
|
6
6
|
|
|
7
7
|
## Separate the counters
|
|
8
8
|
|
|
@@ -22,44 +22,27 @@ have different dates.
|
|
|
22
22
|
|
|
23
23
|
## Prices
|
|
24
24
|
|
|
25
|
-
|
|
26
|
-
change: a quote names this list and its date, and the debit follows the price in force when the
|
|
27
|
-
work runs. If `sl operations --search price` shows a price list command for this identity, read it
|
|
28
|
-
and prefer its figures. A plan or a balance does not change a price.
|
|
25
|
+
Read the current prices before quoting:
|
|
29
26
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
| `CONTACT_LINKEDIN_URL` | 5 |
|
|
34
|
-
| `CONTACT_EMAIL_ADDRESS` | 40 |
|
|
35
|
-
| `CONTACT_PHONE_NUMBER` | 150 |
|
|
36
|
-
| `ORGANIZATION_IDENTITY` | 1 |
|
|
37
|
-
| `ORGANIZATION_WEBSITE` | 1 |
|
|
38
|
-
| `ORGANIZATION_LINKEDIN_URL` | 2 |
|
|
39
|
-
| `ORGANIZATION_ADDRESS` | 2 |
|
|
40
|
-
| `ORGANIZATION_FIRMOGRAPHICS` | 5 |
|
|
41
|
-
| `ORGANIZATION_EMAIL_ADDRESS` | 5 |
|
|
42
|
-
| `ORGANIZATION_PHONE_NUMBER` | 10 |
|
|
43
|
-
|
|
44
|
-
| Outreach LinkedIn action | Credits per action |
|
|
45
|
-
| --- | --- |
|
|
46
|
-
| `linkedinSendMessage` | 5 |
|
|
47
|
-
| `linkedinInvite` | 5 |
|
|
48
|
-
| `linkedinVisit` | 2 |
|
|
49
|
-
| `linkedinLookupProfile` | 2 |
|
|
50
|
-
| `linkedinCancelInvitation` | 1 |
|
|
27
|
+
```bash
|
|
28
|
+
sl billing billing-credit-prices --first 100 --fields billingItem,credits
|
|
29
|
+
```
|
|
51
30
|
|
|
52
|
-
|
|
31
|
+
Each row is a paid item and its credits per unit. Match it to the planned work:
|
|
53
32
|
|
|
54
|
-
|
|
|
33
|
+
| Planned work | Item in the list |
|
|
55
34
|
| --- | --- |
|
|
56
|
-
|
|
|
57
|
-
|
|
|
58
|
-
|
|
|
35
|
+
| Reveal of an Atlas dimension on one record | The dimension in lower case, with `contact.` or `organization.` in front: `CONTACT_EMAIL_ADDRESS` is `atlas.contact.email_address`, `ORGANIZATION_FIRMOGRAPHICS` is `atlas.organization.firmographics` |
|
|
36
|
+
| A LinkedIn action | `outreach.linkedin.` and the action: `send_message`, `invite`, `visit`, `lookup_profile`, `cancel_invitation` |
|
|
37
|
+
| A delivered Signals lead | `signals.lead.` and the watcher definition slug, such as `signals.lead.fundraising` |
|
|
38
|
+
|
|
39
|
+
An item the list does not name costs nothing, as email actions do today. A quote names the date
|
|
40
|
+
the list was read, and the debit follows the price in force when the work runs. A plan or a balance
|
|
41
|
+
does not change a price.
|
|
59
42
|
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
read billing.
|
|
43
|
+
If this identity has no `billing-credit-prices` command (check `sl operations --search price`),
|
|
44
|
+
the prices are unknown: say so, treat the ceiling as unknown and ask before running paid work.
|
|
45
|
+
Never invent a price, use raw GraphQL to look one up, or elevate just to read billing.
|
|
63
46
|
|
|
64
47
|
When a price cannot be established, report the uncertainty. Do not call an estimate a guaranteed
|
|
65
48
|
maximum or execute paid work against an unknown ceiling. Continue with already available data or
|
|
@@ -79,7 +62,7 @@ action. Do not assume all selected records are owned unless the same company and
|
|
|
79
62
|
verified. Reduce the ceiling only for ownership established on that basis. Avoid a broad paid search
|
|
80
63
|
that can select more or different people than the approved set.
|
|
81
64
|
|
|
82
|
-
Arithmetic examples at
|
|
65
|
+
Arithmetic examples, with identity at 2 credits and email at 40:
|
|
83
66
|
|
|
84
67
|
- If identity is 2 credits and email is 40, ten of each cost at most
|
|
85
68
|
`10 × 2 + 10 × 40 = 420` customer credits, for 20 reveal units.
|
|
@@ -123,7 +106,7 @@ An example manifest at the listed price, which is not an approval:
|
|
|
123
106
|
"company": "example-company",
|
|
124
107
|
"environment": "production",
|
|
125
108
|
"verified": true,
|
|
126
|
-
"source": "
|
|
109
|
+
"source": "sl billing billing-credit-prices, 2026-11-10",
|
|
127
110
|
"verifiedAt": "2026-11-10T11:00:00Z",
|
|
128
111
|
"rates": { "CONTACT_IDENTITY": "2" }
|
|
129
112
|
}
|
|
@@ -133,7 +116,7 @@ An example manifest at the listed price, which is not an approval:
|
|
|
133
116
|
Required fields are the exact selected `ids`, exact `dimensions`, payer `company`, `environment`,
|
|
134
117
|
UTC ISO `asOf`, and `tariff`. The tariff must match company/environment, be attested with
|
|
135
118
|
`verified: true`, name its source (an HTTP(S) URL without credentials, or a short label such as
|
|
136
|
-
`
|
|
119
|
+
`sl billing billing-credit-prices, 2026-11-10`) and verification timestamp, and provide every requested
|
|
137
120
|
rate. Optional `tariff.validUntil` must be after `asOf`. The helper rejects future verification
|
|
138
121
|
dates, malformed dates, missing/negative/nonfinite rates, duplicate IDs or dimensions and mixed
|
|
139
122
|
contact/organization dimensions. Quote organizations separately with their own selected IDs,
|
|
@@ -239,7 +222,7 @@ as calculated from the named rate, not as a verified ledger debit. A before/afte
|
|
|
239
222
|
can include other concurrent activity; do not attribute its whole change to this task. No readable
|
|
240
223
|
ledger means final account debit is unverified, not zero.
|
|
241
224
|
|
|
242
|
-
|
|
225
|
+
With those prices, a truthful report is:
|
|
243
226
|
|
|
244
227
|
```text
|
|
245
228
|
Atlas: 19 new reveal units (11 identity, 8 email), company acme.
|