@owlmeans/bot 0.1.18-rc.2 → 0.1.18-rc.3

package/README.md

@@ -1,57 +1,58 @@
 # @owlmeans/bot
 
 The runtime-free, browser-safe contract of OwlMeans chat bots on Telegram, WhatsApp, Discord and
-Slack: what each platform needs and can do, connections, keyword rules (groups) and the one
-Unicode-aware matcher, the `/command` parser, normalized updates and activity, the managing and hook
-protocol trees with their AJV schemas, and the bot error family. A shared package imports it to
+Slack: what each platform needs and can do, connections, the one Unicode-aware text helper a
+handler matches message text with, the `/command` parser, normalized updates and activity, the
+managing and hook protocol trees with their AJV schemas, and the bot error family. A shared package imports it to
 declare the bot routes; a server, a store, the panels and an agent's tools build on it. It stores,
 receives and sends nothing — that is `@owlmeans/server-bot`.
 
 ## Installation
 
 ```bash
-bun add @owlmeans/bot@^0.1.18-rc.2
+bun add @owlmeans/bot@^0.1.18-rc.3
 ```
 
 ## Concepts
 
 - **Connection** — one bot account on one platform, owned by a scope (an organization or the
   application). Clients see `BotConnection`, never a credential; `credentialsSet` names the keys set.
-- **Rule** — a keyword group: keywords, a match mode (`word` / `contains`) and what to do
-  (`BotRuleAction`). `connection: null` applies to every connection of the scope.
-- **Update** — an inbound message normalized across platforms (`BotUpdate`), with the rules it
-  matched already in `matches`.
-- **Activity** — one thing the bot did or tried (`BotActivity`), recorded with `ok` / `error`.
+- **Update** — an inbound message normalized across platforms (`BotUpdate`). What to do with it is
+  the application's handler's decision — it reads the application's own records (keyword groups)
+  and compares the text with `botTextHelper.matched`.
+- **Activity** — one thing the bot did or tried (`BotActivity`), recorded with `ok` / `error` and
+  the handler's opaque `ref` (e.g. the id of the keyword group it followed).
 - **Descriptor** — `BOT_PLATFORMS[platform]`: credentials, receive modes, platform actions, setup.
 
 ## Usage
 
 ```typescript
 import { DEFAULT_GUARD } from '@owlmeans/auth-common'
-import { botCommandHelper, botRuleHelper, makeBotHookProtocols, makeBotProtocols } from '@owlmeans/bot'
+import { BotTextMatch, botCommandHelper, botTextHelper, makeBotHookProtocols, makeBotProtocols } from '@owlmeans/bot'
 
 export const botProtocols = Object.freeze({
   operator: makeBotProtocols({ base: { alias: 'api:bot:operator', path: '/bot/operator' }, guards: DEFAULT_GUARD }),
   hook: makeBotHookProtocols({ base: { alias: 'api:bot:hook', path: '/bot/hook' } }),
 })
 
-const matches = botRuleHelper.match('Free money at the CASINO!', rules)   // enabled rules, by order
-const command = botCommandHelper.parse('/report@MyBot spam', 'MyBot')   // { name: 'report', args: 'spam' }
+const keywords = botTextHelper.phrasesOf('casino, free money')                 // ['casino', 'free money']
+botTextHelper.matched('Free money at the CASINO!', keywords)                   // ['casino', 'free money']
+botTextHelper.matched('megacasino.com', ['casino'], BotTextMatch.Contains)     // ['casino']
+const command = botCommandHelper.parse('/report@MyBot spam', 'MyBot')         // { name: 'report', args: 'spam' }
 ```
 
 ## API
 
 - Enums: `BotPlatform`, `BotReceiveMode`, `BotTransport`, `BotConnectionStatus`, `BotActionKind`,
-  `BotRuleAction`, `BotMatchMode`, `BotUpdateKind`, `BotChatKind`
-- Constants: `BOT_PLATFORMS`, `BOT_*` limits (`BOT_KEYWORDS_MAX`, `BOT_KEYWORD_MAX`,
-  `BOT_ACTIVITY_LIMIT_MAX`, `BOT_ID_PATTERN`, …)
-- Helpers: `botRuleHelper` (`match`, `normalizeKeywords`, `appliesTo`), `botCommandHelper`
+  `BotTextMatch`, `BotUpdateKind`, `BotChatKind`
+- Constants: `BOT_PLATFORMS`, `BOT_*` limits (`BOT_TEXT_MAX`, `BOT_LABEL_MAX`,
+  `BOT_ACTIVITY_LIMIT_MAX`, `BOT_ID_PATTERN`, …), `BOT_MANAGE_PERMISSION`
+- Helpers: `botTextHelper` (`fold`, `tokensOf`, `matched`, `phrasesOf`), `botCommandHelper`
   (`parse`), `botPlatformHelper` (`actionsOf`, `supports`)
 - Protocols: `makeBotProtocols`, `makeBotHookProtocols` and their types (`BotProtocols`,
   `BotHookProtocols`, `BotProtocolOptions`, `BotHookProtocolOptions`, …)
-- Schemas: `BotConnectionInputSchema`, `BotRuleInputSchema`, `BotSimulateInputSchema`,
-  `BotIdParamsSchema`, `BotRuleListQuerySchema`, `BotActivityQuerySchema`, `BotHookParamsSchema`,
-  `BotChallengeQuerySchema`
+- Schemas: `BotConnectionInputSchema`, `BotSimulateInputSchema`, `BotIdParamsSchema`,
+  `BotActivityQuerySchema`, `BotHookParamsSchema`, `BotChallengeQuerySchema`
 - Errors: `BotError`, `BotConnectionNotFound` (404), `BotCredentialsRejected` (422),
   `BotSignatureRejected` (401), `BotTransportMismatch` (409), `BotUnsupportedAction` (422)
 
@@ -61,8 +62,9 @@ const command = botCommandHelper.parse('/report@MyBot spam', 'MyBot')   // { nam
 - Ask `botPlatformHelper.supports(...)` before an action — WhatsApp cannot delete, mute or ban;
   Slack deletes only with the admin `userToken`.
 - Use `contains` for scripts written without spaces; `word` matches whole words and phrases.
+- `simulate` (mock connections only) is an API route for tests and smoke runs — no UI offers it.
 
-The `bot` skill covers matching, the protocols and how a generated target mounts them.
+The `bot` skill covers text matching, the protocols and how a generated target mounts them.
 
 ## Related packages
 

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 3,
   "package": "@owlmeans/bot",
-  "version": "0.1.18-rc.2",
-  "generatedAt": "2026-10-26T22:23:53.842Z",
+  "version": "0.1.18-rc.3",
+  "generatedAt": "2026-10-27T13:25:25.418Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/bot/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: bot
-description: How to use @owlmeans/bot — the runtime-free, browser-safe contract of OwlMeans chat bots on Telegram, WhatsApp, Discord and Slack. Covers the platform descriptors (credentials, receive modes, supported actions), connections, keyword rules (groups) and the Unicode-aware matcher, the /command parser, normalized updates and activity, the managing and hook protocol trees with their AJV schemas, the bot error family, and how a generated target mounts the operator, member and hook trees. Auto-invoked when importing from @owlmeans/bot, declaring bot routes, matching a message against keyword groups, or deciding what a platform can do.
+description: How to use @owlmeans/bot — the runtime-free, browser-safe contract of OwlMeans chat bots on Telegram, WhatsApp, Discord and Slack. Covers the platform descriptors (credentials, receive modes, supported actions), connections, the Unicode-aware text helper a handler matches message text with, the /command parser, normalized updates and activity (with the handler's opaque `ref`), the managing and hook protocol trees with their AJV schemas, the bot error family, and how a generated target mounts the operator, member and hook trees. Auto-invoked when importing from @owlmeans/bot, declaring bot routes, matching a message against phrases (an application's own keyword groups), or deciding what a platform can do.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,15 +8,17 @@ user-invocable: false
 # @owlmeans/bot
 
 **Layer:** Cross-cutting domain (contracts only)
-**Install:** `"@owlmeans/bot": "^0.1.18-rc.2"` in `dependencies`
+**Install:** `"@owlmeans/bot": "^0.1.18-rc.3"` in `dependencies`
 **Runtime-free:** no network, no storage, no logging — enums, descriptors, interfaces, AJV schemas
-(plain objects), two pure helpers, protocol factories and registered errors. Safe in a browser.
+(plain objects), three pure helpers, protocol factories and registered errors. Safe in a browser.
 
 A bot connection is ONE bot account on one platform, owned by a **scope** (the organization — or the
-application itself — that runs it). Its **rules** are keyword groups: keywords + what to do with a
-matching message. The server half (`@owlmeans/server-bot`) stores, verifies, receives, matches and
-acts; `@owlmeans/bot-postgres` persists; `@owlmeans/web-bot` draws the panels; `@owlmeans/bot-agent`
-gives an agent the actions as tools. Every one of them speaks the vocabulary declared here.
+application itself — that runs it). What the bot does with a message is the APPLICATION's code: a
+handler reads the application's own records (its keyword groups, its requests) and calls the
+actions. No package here stores a keyword group or decides on a message. The server half
+(`@owlmeans/server-bot`) stores connections, verifies, receives and acts; `@owlmeans/bot-postgres`
+persists; `@owlmeans/web-bot` draws the connection and activity panels; `@owlmeans/bot-agent` gives
+an agent the actions as tools. Every one of them speaks the vocabulary declared here.
 
 ## Key Exports
 
@@ -25,21 +27,19 @@ gives an agent the actions as tools. Every one of them speaks the vocabulary dec
 | `BotPlatform` | `telegram` · `whatsapp` · `discord` · `slack` |
 | `BotReceiveMode` / `BotTransport` / `BotConnectionStatus` | `webhook`·`poll`·`gateway` / `live`·`mock` / `pending`·`connected`·`failed`·`disabled` |
 | `BotActionKind` | platform calls: `reply` `send` `delete` `mute` `ban` `react`, plus `note` (activity only) |
-| `BotRuleAction` | what a group tells the bot: `delete` `warn` `mute` `ban` `reply` `record` `agent` |
-| `BotMatchMode` / `BotUpdateKind` / `BotChatKind` | `word`·`contains` / `message`·`edited`·`command`·`member` / `private`·`group`·`channel` |
+| `BotTextMatch` / `BotUpdateKind` / `BotChatKind` | `word`·`contains` / `message`·`edited`·`command`·`member` / `private`·`group`·`channel` |
 | `BOT_PLATFORMS` | `Record<BotPlatform, BotPlatformDescriptor>` — credentials, receive modes, actions, setup, docs |
 | `BotConnection` / `BotConnectionInput` | the client view (never a credential) / the write (credentials write-only) |
-| `BotRule` / `BotRuleInput` / `BotMatch` | a keyword group / its write / a matched group with its matched keywords |
 | `BotUpdate`, `BotMessage`, `BotMessageRef`, `BotChatRef`, `BotSenderRef`, `BotCommand` | the normalized inbound update a handler receives |
-| `BotActivity`, `BotSimulateInput`, `BotSimulateResult` | one recorded action (a failure carries `error`, a sentence, and `code`, its `bot:<marker>:` marker); the simulator's input and answer `{ update, duplicate? }` |
-| `botRuleHelper` | `match(text, rules)`, `normalizeKeywords(list)`, `appliesTo(rule, connection)` |
+| `BotActivity`, `BotSimulateInput`, `BotSimulateResult` | one recorded action (a failure carries `error`, a sentence, and `code`, its `bot:<marker>:` marker; `ref` is the handler's opaque reference); the API-only simulate input and answer `{ update, duplicate? }` |
+| `botTextHelper` | `fold(text)`, `tokensOf(text)`, `matched(text, phrases, mode?)`, `phrasesOf(input)` |
 | `botCommandHelper` | `parse(text, botUsername?) → BotCommand \| null` |
 | `botPlatformHelper` | `actionsOf(platform, credentialsSet?)`, `supports(platform, kind, credentialsSet?)` |
-| `makeBotProtocols(opts)` → `BotProtocols` | the managing tree (connections, rules, activity) |
+| `makeBotProtocols(opts)` → `BotProtocols` | the managing tree (connections, activity) |
 | `makeBotHookProtocols(opts)` → `BotHookProtocols` | the platforms' inbound tree (`receive`, `challenge`) |
-| `Bot*Schema` | `BotConnectionInputSchema`, `BotRuleInputSchema`, `BotSimulateInputSchema`, `BotIdParamsSchema`, `BotRuleListQuerySchema`, `BotActivityQuerySchema`, `BotHookParamsSchema`, `BotChallengeQuerySchema` |
+| `Bot*Schema` | `BotConnectionInputSchema`, `BotSimulateInputSchema`, `BotIdParamsSchema`, `BotActivityQuerySchema`, `BotHookParamsSchema`, `BotChallengeQuerySchema` |
 | `BotError` family | `BotConnectionNotFound` 404, `BotCredentialsRejected` 422, `BotSignatureRejected` 401, `BotTransportMismatch` 409, `BotUnsupportedAction` 422 |
-| `BOT_*` limits | `BOT_KEYWORDS_MAX` 200, `BOT_KEYWORD_MAX` 100, `BOT_ACTIVITY_LIMIT_MAX` 200 / `_DEFAULT` 50, `BOT_ID_PATTERN` … |
+| `BOT_*` limits | `BOT_TEXT_MAX` 4096, `BOT_LABEL_MAX` 120, `BOT_ACTIVITY_LIMIT_MAX` 200 / `_DEFAULT` 50, `BOT_ID_PATTERN` … |
 | `BOT_MANAGE_PERMISSION` | `'bot--manage'` — the permission the member mount's gate requires (organization owners hold it by default where users work in organizations; otherwise granted explicitly) |
 
 ## Platforms
@@ -58,25 +58,27 @@ gives an agent the actions as tools. Every one of them speaks the vocabulary dec
 - A `generated` credential (WhatsApp `verifyToken`) is created by the server and shown in the
   connection's `setup` steps; nobody types it.
 
-## Matching rules
-
-`botRuleHelper.match(text, rules)` is the ONE matcher — the server's dispatch, the panels and the
-tests call it, so a group means the same thing everywhere.
-
-- Both sides fold: NFKC, then a case fold (`ß` ≡ `ss`, `Ё` ≡ `ё`, full-width ≡ ASCII). Accents are
-  kept: `cafe` does not match `café`.
-- `word`: tokens are runs of letters, combining marks, digits and `_`; punctuation splits. A
-  multi-word keyword is a PHRASE — consecutive tokens (`free money` matches `FREE, money!`, not
-  `money for free`). A keyword with no letters or digits never matches a word.
-- `contains`: a substring of the folded text, whitespace runs collapsed — also the mode for scripts
-  written without spaces (Chinese, Japanese, Thai), where a word is the whole run.
-- Disabled rules never match; results are sorted by `order` (ties keep the given order); each
-  `BotMatch.keywords` lists the rule's keywords, as stored, that matched.
-- Which rules apply to a connection is `appliesTo`: its own, or a scope-wide one (`connection`
-  `null`/absent). The runtime filters with it before matching.
-- `normalizeKeywords(list)` is what a store keeps: trimmed, inner whitespace collapsed, ≤
-  `BOT_KEYWORD_MAX` code points, empties and folded duplicates dropped (first spelling kept), ≤
-  `BOT_KEYWORDS_MAX` items.
+## Matching text
+
+`botTextHelper` is the ONE way message text is compared with phrases — a generated handler matching
+the application's own keyword groups, the runtime smoke and the tests call it, so a phrase means the
+same thing everywhere. The packages hold no keyword group: the application's records carry the
+phrases, its handler loads them and asks `matched`.
+
+- Both sides fold (`fold`): NFKC, then a case fold, then NFKC (`ß` ≡ `ss`, `Ё` ≡ `ё`, full-width ≡
+  ASCII, ligatures ≡ letters). Accents are kept: `cafe` does not match `café`.
+- `matched(text, phrases, BotTextMatch.Word)` (the default): tokens are runs of letters, combining
+  marks, digits and `_`; punctuation splits. A multi-word phrase must appear as CONSECUTIVE tokens
+  (`free money` matches `FREE, money!`, not `money for free`). A phrase with no letters or digits
+  never matches a word.
+- `BotTextMatch.Contains`: a substring of the folded text, whitespace runs collapsed — also the mode
+  for scripts written without spaces (Chinese, Japanese, Thai), where a word is the whole run.
+- The answer lists the phrases found, in the order given, each once (a folded repeat is skipped, the
+  first spelling answers). Blank phrases and an empty text match nothing.
+- `phrasesOf(input)` turns what a person typed (a string, or a list whose items may hold several)
+  into phrases: split on commas and line breaks, trimmed, inner whitespace collapsed, empties and
+  folded duplicates dropped (first spelling kept). A form or a model normalizes keywords with it
+  before saving them.
 
 `botCommandHelper.parse('/report@MyBot some args', 'MyBot')` → `{ name: 'report', args: 'some args' }`.
 The name is lower-cased and must end at whitespace or the end (`/usr/bin` is no command); a command
@@ -91,24 +93,21 @@ makeBotProtocols({ base: { alias, path, parent?, service? }, guards?, gates? }):
 // connection.save     POST   /connections   BotConnectionInput → BotConnection
 // connection.verify   POST   /connections/:id/verify     → BotConnection
 // connection.remove   DELETE /connections/:id            → { id }
-// connection.simulate POST   /connections/:id/simulate  BotSimulateInput → BotSimulateResult (mock only)
-// rule.list           GET    /rules?connection=          → BotRule[]
-// rule.save           POST   /rules         BotRuleInput → BotRule
-// rule.remove         DELETE /rules/:id                  → { id }
+// connection.simulate POST   /connections/:id/simulate  BotSimulateInput → BotSimulateResult (mock only, API only)
 // activity.list       GET    /activity?connection=&limit= → BotActivity[] (newest first, limit ≤ 200)
 makeBotHookProtocols({ base: { alias, path, parent?, service? } }): BotHookProtocols
 // receive    POST /:platform/:connection   (native payload, no body schema)
 // challenge  GET  /:platform/:connection   (WhatsApp hub.* handshake → the challenge string)
 ```
 
-- Aliases derive from the base: `<alias>:connection:list`, `<alias>:rule:save`, `<alias>:receive` …
+- Aliases derive from the base: `<alias>:connection:list`, `<alias>:activity:list`, `<alias>:receive` …
   Two mounts are two base aliases.
 - `gates` is the gate the base carries (`{ alias, params? }` — a protocol has exactly one gate).
 - **The hook tree carries no guard and no gate, on purpose: the platform signs.** Telegram's secret
   token, WhatsApp's app-secret HMAC and Slack's signing secret are verified by the server against the
   connection's credentials over the RAW body — never put an auth guard in front of it, never add a
   body schema.
-- List queries are required on the client: `rule.list.call({ query: {} })`.
+- List queries are required on the client: `activity.list.call({ query: {} })`.
 
 ## Rules for consumers
 
@@ -116,12 +115,16 @@ makeBotHookProtocols({ base: { alias, path, parent?, service? } }): BotHookProto
   `{ ok, error?, code? }` and records a `BotActivity` with both; a handler checks `ok`, never wraps in
   try/catch to "handle" a platform refusal, and asks `supports(kind)` before an action its platform
   may lack. `error` is one sentence for a person or a model; `code` is the marker code compares.
-- A handler reacts to `update.matches` (already filtered and ordered) — it never re-matches text
-  and never calls a platform API by hand.
+- A handler decides on the update itself: it reads the application's own records (keyword groups
+  for `update.scope`, and its connection where the records are bound to one), compares the text
+  with `botTextHelper.matched`, and acts through `BotActions` with `{ ref }` — the id of the record
+  it followed, recorded on the activity. It never calls a platform API by hand.
 - `BotConnection` never carries a credential; `credentialsSet` says which keys hold a value. In a
   `BotConnectionInput`, an omitted credential key keeps its stored value; `''` is spellable (clear).
 - `simulate` exists only for `transport: 'mock'`; on a live connection it is `BotTransportMismatch`.
-  The server hands the platform's native payload straight to normalization and the inbox — no hook.
+  It is reachable through the API alone — the runtime smoke and end-to-end tests call it; no UI
+  offers a mock transport or a simulator. The server hands the platform's native payload straight to
+  normalization and the inbox — no hook.
   `BotSimulateResult.duplicate: true` means the payload was already in the inbox: `update` is the
   existing row and nothing new is dispatched — a caller waiting for a reaction stops there.
 - Chat members are not application users: nothing of theirs is a guest endpoint; their messages
@@ -169,9 +172,28 @@ export const botProtocols = Object.freeze({
   tenancy, the acting organization otherwise — and the hook tree with `serveBotHookEntrypoints`.
 - Hook URL: `https://<host>/api/bot/hook/<platform>/<connection>` — the host of the request that
   saved or verified the connection, so preview, production and custom domains all work.
-- The web screens host `BotConnectionsPanel` / `BotRulesPanel` / `BotActivityPanel` with
-  `surface = appProtocols.api.bot.operator` (or `.member`); handlers live in
-  `sources/backend/src/bot/handlers/` and run in the worker (`bot.runtime(handlers)`).
+- The web screens host `BotConnectionsPanel` (the connection dialog) and `BotActivityPanel` with
+  `surface = appProtocols.api.bot.operator` (or `.member`). Keyword groups are the target's OWN
+  generated records — type, API, collection and form screens like any product record.
+- Handlers live in `sources/backend/src/bot/handlers/`, listed by the generated barrel
+  `handlers/index.ts`, and run in the worker (`bot.runtime(handlers)`). A keyword handler loads the
+  groups for `update.scope` through the backend model, matches with `botTextHelper.matched` and
+  acts with `{ ref: group.id }`:
+
+```ts
+// sources/backend/src/bot/handlers/moderate.ts — the keyword group is the app's own record
+import { botTextHelper } from '@owlmeans/bot'
+import { botHandler } from '@owlmeans/server-bot'
+
+export const moderate = botHandler('moderate', async (update, bot, ctx) => {
+  const text = update.message?.text ?? ''
+  for (const group of await makeKeywordGroupModel(ctx).enabledOf(update.scope)) {
+    if (botTextHelper.matched(text, group.keywords).length > 0) {
+      await bot.delete(update, { ref: group.id })
+    }
+  }
+})
+```
 
 ## Depends On
 

package/build/consts.d.ts

@@ -50,23 +50,8 @@ export declare enum BotActionKind {
     React = "react",
     Note = "note"
 }
-/**
- * What a keyword group (a rule) tells the bot to do with a message it matches.
- *
- * A product vocabulary, not a platform one: `warn` is a reply, `record` is a request record of the
- * product, `agent` hands the message to the product's own agent.
- */
-export declare enum BotRuleAction {
-    Delete = "delete",
-    Warn = "warn",
-    Mute = "mute",
-    Ban = "ban",
-    Reply = "reply",
-    Record = "record",
-    Agent = "agent"
-}
-/** How a rule's keywords are compared with a message. */
-export declare enum BotMatchMode {
+/** How `botTextHelper.matched` compares a phrase with a message. */
+export declare enum BotTextMatch {
     /** Whole words and whole phrases (consecutive words), Unicode-aware and case-insensitive. */
     Word = "word",
     /** A case-insensitive substring — also the mode for scripts written without spaces. */
@@ -83,22 +68,12 @@ export declare enum BotChatKind {
     Group = "group",
     Channel = "channel"
 }
-/** The longest identifier (connection, rule, activity, update) the wire accepts. */
+/** The longest identifier (connection, activity, update) the wire accepts. */
 export declare const BOT_ID_MAX = 128;
 /** What an identifier on the wire may look like — it is also a path segment of the hook URL. */
 export declare const BOT_ID_PATTERN = "^[A-Za-z0-9][A-Za-z0-9_.:-]*$";
 /** The longest connection label. */
 export declare const BOT_LABEL_MAX = 120;
-/** The longest rule (keyword group) name. */
-export declare const BOT_RULE_NAME_MAX = 120;
-/** How many keywords one rule keeps. */
-export declare const BOT_KEYWORDS_MAX = 200;
-/** The longest keyword or phrase, in code points. */
-export declare const BOT_KEYWORD_MAX = 100;
-/** The longest fixed reply text of a rule. */
-export declare const BOT_REPLY_MAX = 4096;
-/** The longest instruction a rule hands to the product's agent. */
-export declare const BOT_INSTRUCTION_MAX = 4000;
 /** The longest message text the simulator accepts. */
 export declare const BOT_TEXT_MAX = 4096;
 /** The longest single credential value. */
@@ -115,9 +90,9 @@ export declare const BOT_ACTIVITY_LIMIT_MAX = 200;
 export declare const BOT_ACTIVITY_LIMIT_DEFAULT = 50;
 /**
  * The permission the MEMBER mount's gate requires (`gates: { alias: OIDC_GATE, params:
- * [BOT_MANAGE_PERMISSION] }`) — who may connect an organization's bots, edit its keyword groups and
- * read its bot activity. In a product whose users work in organizations, an organization's owners hold
- * it by default; otherwise it is only ever granted explicitly.
+ * [BOT_MANAGE_PERMISSION] }`) — who may connect an organization's bots and read its bot activity.
+ * In a product whose users work in organizations, an organization's owners hold it by default;
+ * otherwise it is only ever granted explicitly.
  */
 export declare const BOT_MANAGE_PERMISSION = "bot--manage";
 /**

package/build/consts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAEvD,4DAA4D;AAC5D,oBAAY,WAAW;IACrB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,wDAAwD;AACxD,oBAAY,cAAc;IACxB,oEAAoE;IACpE,OAAO,YAAY;IACnB,wEAAwE;IACxE,IAAI,SAAS;IACb,gFAAgF;IAChF,OAAO,YAAY;CACpB;AAED;;;;;GAKG;AACH,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,oBAAY,mBAAmB;IAC7B,+BAA+B;IAC/B,OAAO,YAAY;IACnB,qFAAqF;IACrF,SAAS,cAAc;IACvB,sEAAsE;IACtE,MAAM,WAAW;IACjB,8DAA8D;IAC9D,QAAQ,aAAa;CACtB;AAED;;;;;GAKG;AACH,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAED;;;;;GAKG;AACH,oBAAY,aAAa;IACvB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED,yDAAyD;AACzD,oBAAY,YAAY;IACtB,6FAA6F;IAC7F,IAAI,SAAS;IACb,uFAAuF;IACvF,QAAQ,aAAa;CACtB;AAED,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED,oFAAoF;AACpF,eAAO,MAAM,UAAU,MAAM,CAAA;AAE7B,gGAAgG;AAChG,eAAO,MAAM,cAAc,kCAAkC,CAAA;AAE7D,oCAAoC;AACpC,eAAO,MAAM,aAAa,MAAM,CAAA;AAEhC,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB,MAAM,CAAA;AAEpC,wCAAwC;AACxC,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC,qDAAqD;AACrD,eAAO,MAAM,eAAe,MAAM,CAAA;AAElC,8CAA8C;AAC9C,eAAO,MAAM,aAAa,OAAO,CAAA;AAEjC,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAEvC,sDAAsD;AACtD,eAAO,MAAM,YAAY,OAAO,CAAA;AAEhC,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,OAAO,CAAA;AAEtC,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,2CAA2C;AAC3C,eAAO,MAAM,0BAA0B,gCAAgC,CAAA;AAEvE,yFAAyF;AACzF,eAAO,MAAM,YAAY,MAAM,CAAA;AAE/B,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,gBAAgB,CAAA;AAElD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,qBAAqB,CAyDrB,CAAA"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAEvD,4DAA4D;AAC5D,oBAAY,WAAW;IACrB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,wDAAwD;AACxD,oBAAY,cAAc;IACxB,oEAAoE;IACpE,OAAO,YAAY;IACnB,wEAAwE;IACxE,IAAI,SAAS;IACb,gFAAgF;IAChF,OAAO,YAAY;CACpB;AAED;;;;;GAKG;AACH,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,oBAAY,mBAAmB;IAC7B,+BAA+B;IAC/B,OAAO,YAAY;IACnB,qFAAqF;IACrF,SAAS,cAAc;IACvB,sEAAsE;IACtE,MAAM,WAAW;IACjB,8DAA8D;IAC9D,QAAQ,aAAa;CACtB;AAED;;;;;GAKG;AACH,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAED,oEAAoE;AACpE,oBAAY,YAAY;IACtB,6FAA6F;IAC7F,IAAI,SAAS;IACb,uFAAuF;IACvF,QAAQ,aAAa;CACtB;AAED,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED,8EAA8E;AAC9E,eAAO,MAAM,UAAU,MAAM,CAAA;AAE7B,gGAAgG;AAChG,eAAO,MAAM,cAAc,kCAAkC,CAAA;AAE7D,oCAAoC;AACpC,eAAO,MAAM,aAAa,MAAM,CAAA;AAEhC,sDAAsD;AACtD,eAAO,MAAM,YAAY,OAAO,CAAA;AAEhC,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,OAAO,CAAA;AAEtC,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,2CAA2C;AAC3C,eAAO,MAAM,0BAA0B,gCAAgC,CAAA;AAEvE,yFAAyF;AACzF,eAAO,MAAM,YAAY,MAAM,CAAA;AAE/B,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,gBAAgB,CAAA;AAElD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,qBAAqB,CAyDrB,CAAA"}

package/build/consts.js

@@ -54,30 +54,14 @@ export var BotActionKind;
     BotActionKind["React"] = "react";
     BotActionKind["Note"] = "note";
 })(BotActionKind || (BotActionKind = {}));
-/**
- * What a keyword group (a rule) tells the bot to do with a message it matches.
- *
- * A product vocabulary, not a platform one: `warn` is a reply, `record` is a request record of the
- * product, `agent` hands the message to the product's own agent.
- */
-export var BotRuleAction;
-(function (BotRuleAction) {
-    BotRuleAction["Delete"] = "delete";
-    BotRuleAction["Warn"] = "warn";
-    BotRuleAction["Mute"] = "mute";
-    BotRuleAction["Ban"] = "ban";
-    BotRuleAction["Reply"] = "reply";
-    BotRuleAction["Record"] = "record";
-    BotRuleAction["Agent"] = "agent";
-})(BotRuleAction || (BotRuleAction = {}));
-/** How a rule's keywords are compared with a message. */
-export var BotMatchMode;
-(function (BotMatchMode) {
+/** How `botTextHelper.matched` compares a phrase with a message. */
+export var BotTextMatch;
+(function (BotTextMatch) {
     /** Whole words and whole phrases (consecutive words), Unicode-aware and case-insensitive. */
-    BotMatchMode["Word"] = "word";
+    BotTextMatch["Word"] = "word";
     /** A case-insensitive substring — also the mode for scripts written without spaces. */
-    BotMatchMode["Contains"] = "contains";
-})(BotMatchMode || (BotMatchMode = {}));
+    BotTextMatch["Contains"] = "contains";
+})(BotTextMatch || (BotTextMatch = {}));
 export var BotUpdateKind;
 (function (BotUpdateKind) {
     BotUpdateKind["Message"] = "message";
@@ -91,22 +75,12 @@ export var BotChatKind;
     BotChatKind["Group"] = "group";
     BotChatKind["Channel"] = "channel";
 })(BotChatKind || (BotChatKind = {}));
-/** The longest identifier (connection, rule, activity, update) the wire accepts. */
+/** The longest identifier (connection, activity, update) the wire accepts. */
 export const BOT_ID_MAX = 128;
 /** What an identifier on the wire may look like — it is also a path segment of the hook URL. */
 export const BOT_ID_PATTERN = '^[A-Za-z0-9][A-Za-z0-9_.:-]*$';
 /** The longest connection label. */
 export const BOT_LABEL_MAX = 120;
-/** The longest rule (keyword group) name. */
-export const BOT_RULE_NAME_MAX = 120;
-/** How many keywords one rule keeps. */
-export const BOT_KEYWORDS_MAX = 200;
-/** The longest keyword or phrase, in code points. */
-export const BOT_KEYWORD_MAX = 100;
-/** The longest fixed reply text of a rule. */
-export const BOT_REPLY_MAX = 4096;
-/** The longest instruction a rule hands to the product's agent. */
-export const BOT_INSTRUCTION_MAX = 4000;
 /** The longest message text the simulator accepts. */
 export const BOT_TEXT_MAX = 4096;
 /** The longest single credential value. */
@@ -123,9 +97,9 @@ export const BOT_ACTIVITY_LIMIT_MAX = 200;
 export const BOT_ACTIVITY_LIMIT_DEFAULT = 50;
 /**
  * The permission the MEMBER mount's gate requires (`gates: { alias: OIDC_GATE, params:
- * [BOT_MANAGE_PERMISSION] }`) — who may connect an organization's bots, edit its keyword groups and
- * read its bot activity. In a product whose users work in organizations, an organization's owners hold
- * it by default; otherwise it is only ever granted explicitly.
+ * [BOT_MANAGE_PERMISSION] }`) — who may connect an organization's bots and read its bot activity.
+ * In a product whose users work in organizations, an organization's owners hold it by default;
+ * otherwise it is only ever granted explicitly.
  */
 export const BOT_MANAGE_PERMISSION = 'bot--manage';
 /**

package/build/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAEA,4DAA4D;AAC5D,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,oCAAqB,CAAA;IACrB,oCAAqB,CAAA;IACrB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;AACjB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB;AAED,wDAAwD;AACxD,MAAM,CAAN,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,oEAAoE;IACpE,qCAAmB,CAAA;IACnB,wEAAwE;IACxE,+BAAa,CAAA;IACb,gFAAgF;IAChF,qCAAmB,CAAA;AACrB,CAAC,EAPW,cAAc,KAAd,cAAc,QAOzB;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,6BAAa,CAAA;AACf,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AAED,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,+BAA+B;IAC/B,0CAAmB,CAAA;IACnB,qFAAqF;IACrF,8CAAuB,CAAA;IACvB,sEAAsE;IACtE,wCAAiB,CAAA;IACjB,8DAA8D;IAC9D,4CAAqB,CAAA;AACvB,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,8BAAa,CAAA;IACb,4BAAW,CAAA;IACX,gCAAe,CAAA;IACf,8BAAa,CAAA;AACf,CAAC,EARW,aAAa,KAAb,aAAa,QAQxB;AAED,oEAAoE;AACpE,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,6FAA6F;IAC7F,6BAAa,CAAA;IACb,uFAAuF;IACvF,qCAAqB,CAAA;AACvB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,kCAAiB,CAAA;IACjB,oCAAmB,CAAA;IACnB,kCAAiB,CAAA;AACnB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAED,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,8BAAe,CAAA;IACf,kCAAmB,CAAA;AACrB,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAA;AAE7B,gGAAgG;AAChG,MAAM,CAAC,MAAM,cAAc,GAAG,+BAA+B,CAAA;AAE7D,oCAAoC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAA;AAEhC,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAA;AAEhC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAA;AAEtC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAA;AAErC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,6BAA6B,CAAA;AAEvE,yFAAyF;AACzF,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAA;AAE/B,+CAA+C;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAA;AAEzC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAA;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAA+C,MAAM,CAAC,MAAM,CAAC;IACrF,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;QACpC,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;YACzB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;SAC9D,CAAC;QACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;QACrE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG;YACpG,aAAa,CAAC,KAAK;SACpB,CAAC;QACF,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,+DAA+D;KACtE,CAAC;IACF,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;QACpC,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;YACzB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACnE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACtE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACjE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SACrF,CAAC;QACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;QACtF,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,qEAAqE;KAC5E,CAAC;IACF,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;QACnC,QAAQ,EAAE,WAAW,CAAC,OAAO;QAC7B,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;YACzB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;SACvE,CAAC;QACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG;YACpG,aAAa,CAAC,KAAK;SACpB,CAAC;QACF,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,iEAAiE;KACxE,CAAC;IACF,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;QACjC,QAAQ,EAAE,WAAW,CAAC,KAAK;QAC3B,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;YACzB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAChE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACrE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;SACnH,CAAC;QACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;QACtF,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,uCAAuC;KAC9C,CAAC;CACH,CAA+C,CAAA"}

package/build/consts.local.d.ts

@@ -3,8 +3,10 @@
  * (Devanagari vowel signs, a decomposed accent left after folding), so a word never splits on one.
  */
 export declare const BOT_TOKEN_PATTERN: RegExp;
-/** Any whitespace run — collapsed to one space before a `contains` comparison and in a stored keyword. */
+/** Any whitespace run — collapsed to one space before a `contains` comparison and in a typed phrase. */
 export declare const BOT_SPACE_PATTERN: RegExp;
+/** What separates the phrases of a typed list: commas (ASCII, full-width, ideographic) and line breaks. */
+export declare const BOT_PHRASE_SEPARATOR_PATTERN: RegExp;
 /**
  * A `/command`, optionally addressed `@ToBot`, ending at whitespace or at the end of the text, then
  * its arguments.

package/build/consts.local.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAA0B,CAAA;AAExD,0GAA0G;AAC1G,eAAO,MAAM,iBAAiB,QAAU,CAAA;AAExC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAA6E,CAAA"}
+{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAA0B,CAAA;AAExD,wGAAwG;AACxG,eAAO,MAAM,iBAAiB,QAAU,CAAA;AAExC,2GAA2G;AAC3G,eAAO,MAAM,4BAA4B,QAAgB,CAAA;AAEzD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAA6E,CAAA"}

package/build/consts.local.js

@@ -3,8 +3,10 @@
  * (Devanagari vowel signs, a decomposed accent left after folding), so a word never splits on one.
  */
 export const BOT_TOKEN_PATTERN = /[\p{L}\p{M}\p{N}_]+/gu;
-/** Any whitespace run — collapsed to one space before a `contains` comparison and in a stored keyword. */
+/** Any whitespace run — collapsed to one space before a `contains` comparison and in a typed phrase. */
 export const BOT_SPACE_PATTERN = /\s+/gu;
+/** What separates the phrases of a typed list: commas (ASCII, full-width, ideographic) and line breaks. */
+export const BOT_PHRASE_SEPARATOR_PATTERN = /[,，、\r\n]+/u;
 /**
  * A `/command`, optionally addressed `@ToBot`, ending at whitespace or at the end of the text, then
  * its arguments.

package/build/consts.local.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAA;AAExD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAA;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,0EAA0E,CAAA"}
+{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../src/consts.local.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAA;AAExD,wGAAwG;AACxG,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAA;AAExC,2GAA2G;AAC3G,MAAM,CAAC,MAAM,4BAA4B,GAAG,aAAa,CAAA;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,0EAA0E,CAAA"}

package/build/helpers/index.d.ts

@@ -1,7 +1,7 @@
-export type * from './rule/types.js';
+export type * from './text/types.js';
 export type * from './command/types.js';
 export type * from './platform/types.js';
-export * from './rule.js';
+export * from './text.js';
 export * from './command.js';
 export * from './platform.js';
 //# sourceMappingURL=index.d.ts.map

package/build/helpers/index.js

@@ -1,4 +1,4 @@
-export * from './rule.js';
+export * from './text.js';
 export * from './command.js';
 export * from './platform.js';
 //# sourceMappingURL=index.js.map

package/build/helpers/text/types.d.ts

@@ -0,0 +1,35 @@
+import type { BotTextMatch } from '../../consts.js';
+/**
+ * Unicode-aware comparison of a message with phrases — the pure primitive a bot handler matches
+ * message text with (the application's own keyword groups, a command's argument, a reply's text).
+ *
+ * Both sides fold the same way: NFKC, then a case fold, then NFKC again (`ß` ≡ `ss`, `Ё` ≡ `ё`,
+ * full-width ≡ ASCII, ligatures ≡ their letters); accents are kept (`cafe` is not `café`).
+ */
+export interface BotTextHelper {
+    /** The folded form of a text: NFKC, upper- then lower-cased, NFKC again. */
+    fold: (text: string) => string;
+    /**
+     * The folded tokens of a text: runs of letters, combining marks, digits and `_`; everything else
+     * (punctuation, spaces, symbols) splits. `[]` for a text with none.
+     */
+    tokensOf: (text: string) => string[];
+    /**
+     * The phrases found in `text`, in the order they were given, each once — a phrase whose folded
+     * form repeats an earlier one is skipped, so the first spelling answers.
+     *
+     * `word` (the default): the phrase's tokens appear in the text as CONSECUTIVE tokens (`free money`
+     * matches `FREE, money!`, not `money for free`), and a phrase with no letters or digits never
+     * matches. `contains`: the folded phrase is a substring of the folded text, whitespace runs of both
+     * collapsed to one space — also the mode for scripts written without spaces (Chinese, Japanese,
+     * Thai). An empty or blank phrase never matches; an empty text matches nothing.
+     */
+    matched: (text: string, phrases: readonly string[], mode?: BotTextMatch) => string[];
+    /**
+     * A phrase list as a person typed it: every item split on commas and line breaks, each phrase
+     * trimmed with inner whitespace runs collapsed to one space, empties dropped, and a phrase whose
+     * folded form repeats an earlier one dropped (the first spelling kept).
+     */
+    phrasesOf: (input: string | readonly string[]) => string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/build/helpers/text/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/helpers/text/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAC9B;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAA;IACpC;;;;;;;;;OASG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,MAAM,EAAE,CAAA;IACpF;;;;OAIG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,KAAK,MAAM,EAAE,CAAA;CAC3D"}

package/build/helpers/{rule → text}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/helpers/rule/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/helpers/text/types.ts"],"names":[],"mappings":""}

package/build/helpers/text.d.ts

@@ -0,0 +1,4 @@
+import type { BotTextHelper } from './text/types.js';
+export declare const createBotTextHelper: () => BotTextHelper;
+export declare const botTextHelper: BotTextHelper;
+//# sourceMappingURL=text.d.ts.map

package/build/helpers/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/helpers/text.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,eAAO,MAAM,mBAAmB,QAAO,aAoFtC,CAAA;AAED,eAAO,MAAM,aAAa,eAAwB,CAAA"}