@talqing/mcp 0.6.0 → 0.7.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/SKILL.md +22 -8
- package/package.json +1 -1
package/SKILL.md
CHANGED
|
@@ -1144,8 +1144,16 @@ overrides of anything else — one batch is one agent, one number, one clock.
|
|
|
1144
1144
|
weekdays it may dial in, so a list uploaded at 23:00 can start at 11:00
|
|
1145
1145
|
tomorrow, stop at 18:00 and resume at 10:00 on the next weekday untouched. A
|
|
1146
1146
|
window may cross midnight; the days then name the evening it starts on.
|
|
1147
|
-
`next_dial_at` on the batch says when it will dial next
|
|
1148
|
-
"waiting for Monday"
|
|
1147
|
+
`next_dial_at` on the batch says when it will dial next and `next_dial_reason`
|
|
1148
|
+
why (`start`, `window`, `daily_cap`), which is how you tell "waiting for Monday"
|
|
1149
|
+
apart from "stuck".
|
|
1150
|
+
|
|
1151
|
+
**Pace.** `dial_gap_seconds` is the minimum wait between starting two calls (0,
|
|
1152
|
+
the default, dials as slots free). `dial_daily_cap` limits calls placed per
|
|
1153
|
+
local day, retries included: `{kind: "fixed", limit}` or a ramp, `{kind: "ramp",
|
|
1154
|
+
start, end, step, interval_days}`, which rises by `step` every `interval_days`
|
|
1155
|
+
days the batch actually dialled. For a new caller ID suggest a ramp rather than
|
|
1156
|
+
a flat limit. `dialed_today` is measured against `dial_daily_cap_today`.
|
|
1149
1157
|
|
|
1150
1158
|
**Say these two things before creating one**, because a user who discovers
|
|
1151
1159
|
either from an invoice will not forgive us:
|
|
@@ -1242,7 +1250,10 @@ row. `create_email_send` takes a `scope` and returns a **send** you can steer:
|
|
|
1242
1250
|
- `start_at` schedules it, `window` (on its own `timezone`) holds it to business
|
|
1243
1251
|
hours, `send_gap_seconds` is the minimum wait between two emails of the
|
|
1244
1252
|
**batch** (1 second to 1 hour) and `send_daily_cap` bounds how many the batch
|
|
1245
|
-
may send per local day
|
|
1253
|
+
may send per local day: `{kind: "fixed", limit}`, or a ramp, `{kind: "ramp",
|
|
1254
|
+
start, end, step, interval_days}`, which rises by `step` every `interval_days`
|
|
1255
|
+
days the batch actually sent (a weekend or a pause earns nothing). Anything
|
|
1256
|
+
omitted comes from the batch.
|
|
1246
1257
|
- A draft a live send covers reads `queued`, and is still a draft: it can be
|
|
1247
1258
|
edited, skipped or redrafted until the send takes it.
|
|
1248
1259
|
- `pause_email_send` stops on the next email; `resume_email_send` carries on.
|
|
@@ -1254,9 +1265,10 @@ row. `create_email_send` takes a `scope` and returns a **send** you can steer:
|
|
|
1254
1265
|
within five minutes, so raising a spent cap or removing a window needs no
|
|
1255
1266
|
cancel.
|
|
1256
1267
|
|
|
1257
|
-
**The safeguard here is a RATE, not a row count.** `send_daily_cap` (
|
|
1258
|
-
default, per batch, `null` for uncapped) is what stands between a
|
|
1259
|
-
and a sending domain nobody trusts again.
|
|
1268
|
+
**The safeguard here is a RATE, not a row count.** `send_daily_cap` (a fixed
|
|
1269
|
+
200 by default, per batch, `null` for uncapped) is what stands between a
|
|
1270
|
+
5 000-row list and a sending domain nobody trusts again. For a new sending
|
|
1271
|
+
domain, suggest a ramp (say 10 rising to 50) rather than a flat cap. Before creating a send, say how many
|
|
1260
1272
|
emails it is and roughly how long it will take at the pace it has — and if the
|
|
1261
1273
|
user asks to raise or remove the cap, say what it is for rather than just doing
|
|
1262
1274
|
it.
|
|
@@ -1301,7 +1313,7 @@ ours — Resend keeps one and auto-suppresses hard bounces and complaints.
|
|
|
1301
1313
|
|
|
1302
1314
|
`get_email_batch` carries live counts, `skips` (why rows were skipped),
|
|
1303
1315
|
`draft_failures` (why drafts failed, most common first), `failure_reason`,
|
|
1304
|
-
`sent_today` (against `
|
|
1316
|
+
`sent_today` (against `send_daily_cap_today`), `drafted_versions`,
|
|
1305
1317
|
`stale_redraftable` / `stale_sent` and the drafting cost so far. Measure
|
|
1306
1318
|
progress against what can be reached: `unfillable` rows are never drafted, and
|
|
1307
1319
|
skipped, failed or cancelled rows are never sent.
|
|
@@ -1325,7 +1337,9 @@ gives a sender's approved templates — header, body, footer, buttons and variab
|
|
|
1325
1337
|
names; one with `unsupported_reason` cannot be used.
|
|
1326
1338
|
`create_whatsapp_batch` maps `to_column` and every variable onto CSV columns. A
|
|
1327
1339
|
row with a bad or repeated phone, or a blank mapped cell, is kept and skipped
|
|
1328
|
-
with the reason, so read the returned `counts`.
|
|
1340
|
+
with the reason, so read the returned `counts`. `send_daily_cap` takes the same
|
|
1341
|
+
object an email batch's does (a fixed 250 by default); for a new sender suggest
|
|
1342
|
+
a ramp.
|
|
1329
1343
|
|
|
1330
1344
|
**Say these before creating one:**
|
|
1331
1345
|
|
package/package.json
CHANGED