@owlmeans/bot 0.0.0-stage → 0.1.18-rc.2

package/README.md

@@ -1,3 +1,86 @@
-# Temporary Holding Version
+# @owlmeans/bot
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+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
+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
+```
+
+## 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`.
+- **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'
+
+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' }
+```
+
+## 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`
+  (`parse`), `botPlatformHelper` (`actionsOf`, `supports`)
+- Protocols: `makeBotProtocols`, `makeBotHookProtocols` and their types (`BotProtocols`,
+  `BotHookProtocols`, `BotProtocolOptions`, `BotHookProtocolOptions`, …)
+- Schemas: `BotConnectionInputSchema`, `BotRuleInputSchema`, `BotSimulateInputSchema`,
+  `BotIdParamsSchema`, `BotRuleListQuerySchema`, `BotActivityQuerySchema`, `BotHookParamsSchema`,
+  `BotChallengeQuerySchema`
+- Errors: `BotError`, `BotConnectionNotFound` (404), `BotCredentialsRejected` (422),
+  `BotSignatureRejected` (401), `BotTransportMismatch` (409), `BotUnsupportedAction` (422)
+
+## Common pitfalls
+
+- Never put a guard in front of the hook tree: the platform signs the raw body.
+- 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.
+
+The `bot` skill covers matching, the protocols and how a generated target mounts them.
+
+## Related packages
+
+- [`@owlmeans/entrypoint`](../entrypoint) — protocol declarations
+- [`@owlmeans/planning`](../planning) — the same per-mount protocol-factory shape
+
+<!-- owlmeans:agent-guidance:start -->
+## Agent guidance
+
+This package ships embedded agent skills under `agent-meta/`. After installing your
+`@owlmeans/*` packages, run the OwlMeans agent-skills installer to place them into
+your project's skill store (`.agents/skills/`):
+
+```sh
+npx @owlmeans/agent-skills@^0.1.18-rc.59
+```
+
+The embedded files are version-matched to this package release. Do not edit them
+directly — they are regenerated on each publish. To contribute guidance edits,
+open a PR against the source monorepo.
+<!-- owlmeans:agent-guidance:end -->

package/agent-meta/manifest.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 3,
+  "package": "@owlmeans/bot",
+  "version": "0.1.18-rc.2",
+  "generatedAt": "2026-10-26T22:23:53.842Z",
+  "canonicalRepo": "https://github.com/owlmeans/common",
+  "entries": [
+    {
+      "kind": "skill",
+      "name": "bot",
+      "category": "package-specific",
+      "file": "skills/bot/SKILL.md",
+      "canonicalPath": ".agents/skills/bot/SKILL.md"
+    }
+  ]
+}

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

@@ -0,0 +1,187 @@
+---
+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.
+user-invocable: false
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/bot
+
+**Layer:** Cross-cutting domain (contracts only)
+**Install:** `"@owlmeans/bot": "^0.1.18-rc.2"` 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.
+
+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.
+
+## Key Exports
+
+| Export | What it is |
+|---|---|
+| `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` |
+| `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)` |
+| `botCommandHelper` | `parse(text, botUsername?) → BotCommand \| null` |
+| `botPlatformHelper` | `actionsOf(platform, credentialsSet?)`, `supports(platform, kind, credentialsSet?)` |
+| `makeBotProtocols(opts)` → `BotProtocols` | the managing tree (connections, rules, activity) |
+| `makeBotHookProtocols(opts)` → `BotHookProtocols` | the platforms' inbound tree (`receive`, `challenge`) |
+| `Bot*Schema` | `BotConnectionInputSchema`, `BotRuleInputSchema`, `BotSimulateInputSchema`, `BotIdParamsSchema`, `BotRuleListQuerySchema`, `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_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
+
+| Platform | Credentials | Receive | Actions | Setup |
+|---|---|---|---|---|
+| telegram | `token` | webhook, poll | reply send delete mute ban react | auto (`setWebhook` + secret token) |
+| whatsapp | `accessToken`, `phoneNumberId`, `appSecret`, `verifyToken` (generated) | webhook | reply send react | manual (callback URL + verify token) |
+| discord | `token`, `applicationId` | gateway | reply send delete mute (timeout) ban react | auto (gateway; invite URL) |
+| slack | `botToken`, `signingSecret`, optional admin `userToken` | webhook (Events API) | reply send react; `delete` only with `userToken` | manual (Request URL) |
+
+- Ask `botPlatformHelper.supports(platform, kind, connection.credentialsSet)` — never a local table.
+  It adds what an optional credential `enables` and always answers `note` true.
+- A moderation kit on a platform that cannot delete (WhatsApp; Slack without `userToken`) falls back
+  to `warn` (a reply). WhatsApp cannot delete, mute or ban at all.
+- 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.
+
+`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
+addressed to another bot answers `null`; with no `botUsername`, any address is accepted.
+
+## Protocols
+
+```ts
+makeBotProtocols({ base: { alias, path, parent?, service? }, guards?, gates? }): BotProtocols
+// base                                   (carries the guards and the ONE gate)
+// connection.list     GET    /connections                → BotConnection[]
+// 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 }
+// 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` …
+  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: {} })`.
+
+## Rules for consumers
+
+- **Actions never throw.** Every `BotActions` call of `@owlmeans/server-bot` answers
+  `{ 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.
+- `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.
+  `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
+  arrive only through the hook or the worker's receivers.
+- `scope` is decided by the server from the acting organization (`makeEntityScope` / the target's
+  actor) — it is never read from the wire.
+- `BotMessageRef` alone addresses a message: it carries `space` (Discord guild / Slack team) where
+  the platform needs it.
+- Error messages are `bot:<marker>:<detail>`; the UI copy ships with `web-bot` as
+  `lib : bot.errors.<key>` (`botErrorHelper.keyOf` reads the class, then `@owlmeans/server-bot`'s type
+  names, then the marker — an activity's `code`, a connection's `lastError`).
+
+## Target wiring
+
+A generated target (`bot` / `ai-bot` case seed) declares three trees in
+`sources/common/src/bot-protocols.ts` and spreads them into its case protocol surface:
+
+```ts
+import { DEFAULT_GUARD } from '@owlmeans/auth-common'
+import { BOT_MANAGE_PERMISSION, makeBotHookProtocols, makeBotProtocols } from '@owlmeans/bot'
+import { OIDC_GATE } from '@owlmeans/oidc'
+import { OPERATOR_PERMISSION } from './consts.js'
+
+export const botProtocols = Object.freeze({
+  // tenancy none / operators: the operator area runs the bot (/backoffice)
+  operator: makeBotProtocols({
+    base: { alias: 'api:bot:operator', path: '/bot/operator' },
+    guards: DEFAULT_GUARD, gates: { alias: OIDC_GATE, params: [OPERATOR_PERMISSION] },
+  }),
+  // tenancy users: each customer organization runs its own bot (/frontoffice)
+  member: makeBotProtocols({
+    base: { alias: 'api:bot:member', path: '/bot/member' },
+    guards: DEFAULT_GUARD, gates: { alias: OIDC_GATE, params: [BOT_MANAGE_PERMISSION] },
+  }),
+  // the platforms: unguarded, signed
+  hook: makeBotHookProtocols({ base: { alias: 'api:bot:hook', path: '/bot/hook' } }),
+})
+```
+
+- The member mount's gate requires `BOT_MANAGE_PERMISSION` (`'bot--manage'`) — import it, never
+  respell it: the platform and the target seed read the same constant. Where users work in
+  organizations, an organization's owners hold it by default; otherwise it is only granted explicitly.
+- The api binds each managing tree with `serveBotEntrypoints(tree, { scope })` (`@owlmeans/server-bot`),
+  `scope` from the target's actor — the application's own organization for `operator` without
+  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)`).
+
+## Depends On
+
+- `@owlmeans/entrypoint`, `@owlmeans/route` — the protocol trees
+- `@owlmeans/error` — the `BotError` family
+- `@owlmeans/context`
+- `ajv` (peer, types only) — the `JSONSchemaType` of the schemas
+
+## Related
+
+- [[entrypoint]] — immutable protocols, `bind` / `bindAll`
+- [[planning]] — the same per-mount protocol-factory shape (`makePlanningProtocols`)
+- [[viable-common]] — `BlueprintCase.Bot` / `AiBot`, `BotKit`, the card's `botPlatforms` / `botKit`

package/build/consts.d.ts

@@ -0,0 +1,132 @@
+import type { BotPlatformDescriptor } from './types.js';
+/** The messaging platforms a bot connection can live on. */
+export declare enum BotPlatform {
+    Telegram = "telegram",
+    WhatsApp = "whatsapp",
+    Discord = "discord",
+    Slack = "slack"
+}
+/** How a connection's updates reach the application. */
+export declare enum BotReceiveMode {
+    /** The platform POSTs every update to the connection's hook URL. */
+    Webhook = "webhook",
+    /** The worker asks the platform for updates (Telegram long polling). */
+    Poll = "poll",
+    /** The worker holds a socket the platform pushes over (the Discord gateway). */
+    Gateway = "gateway"
+}
+/**
+ * Who answers a connection's platform calls.
+ *
+ * `mock` is the platform's API faithfully faked — no network, every call recorded as activity — so a
+ * preview, a test or an end-to-end run exercises the exact live path without a real bot.
+ */
+export declare enum BotTransport {
+    Live = "live",
+    Mock = "mock"
+}
+export declare enum BotConnectionStatus {
+    /** Saved, not verified yet. */
+    Pending = "pending",
+    /** The platform accepted the credentials and the receiver is (or can be) running. */
+    Connected = "connected",
+    /** The last verification or receive failed — `lastError` says why. */
+    Failed = "failed",
+    /** Switched off by its owner; nothing is received or sent. */
+    Disabled = "disabled"
+}
+/**
+ * What a bot can DO — the platform calls a handler makes, each recorded as one activity.
+ *
+ * `note` is the exception: it records an activity and makes no platform call, so every connection
+ * supports it and no platform descriptor lists it.
+ */
+export declare enum BotActionKind {
+    Reply = "reply",
+    Send = "send",
+    Delete = "delete",
+    Mute = "mute",
+    Ban = "ban",
+    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 {
+    /** 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. */
+    Contains = "contains"
+}
+export declare enum BotUpdateKind {
+    Message = "message",
+    Edited = "edited",
+    Command = "command",
+    Member = "member"
+}
+export declare enum BotChatKind {
+    Private = "private",
+    Group = "group",
+    Channel = "channel"
+}
+/** The longest identifier (connection, rule, 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. */
+export declare const BOT_CREDENTIAL_MAX = 4096;
+/** How many credential keys one connection input may carry. */
+export declare const BOT_CREDENTIALS_MAX = 16;
+/** What a credential key may look like. */
+export declare const BOT_CREDENTIAL_KEY_PATTERN = "^[A-Za-z][A-Za-z0-9]{0,63}$";
+/** The longest free-text field of a simulated chat or sender (title, name, username). */
+export declare const BOT_NAME_MAX = 256;
+/** The most activity rows one read returns. */
+export declare const BOT_ACTIVITY_LIMIT_MAX = 200;
+/** The activity rows a read returns when it names no limit. */
+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.
+ */
+export declare const BOT_MANAGE_PERMISSION = "bot--manage";
+/**
+ * What each platform needs and can do — the one table every layer reads: the panel draws the
+ * credential inputs from it, the server verifies and acts by it, generation picks actions from it.
+ *
+ * `actions` lists the platform CALLS a connection can make with its required credentials; an
+ * optional credential's `enables` adds more (Slack's admin `userToken` adds `delete`). `note` is never
+ * listed — it makes no platform call (`botPlatformHelper.actionsOf` answers the full set).
+ */
+export declare const BOT_PLATFORMS: Record<BotPlatform, BotPlatformDescriptor>;
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +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"}

package/build/consts.js

@@ -0,0 +1,197 @@
+/** The messaging platforms a bot connection can live on. */
+export var BotPlatform;
+(function (BotPlatform) {
+    BotPlatform["Telegram"] = "telegram";
+    BotPlatform["WhatsApp"] = "whatsapp";
+    BotPlatform["Discord"] = "discord";
+    BotPlatform["Slack"] = "slack";
+})(BotPlatform || (BotPlatform = {}));
+/** How a connection's updates reach the application. */
+export var BotReceiveMode;
+(function (BotReceiveMode) {
+    /** The platform POSTs every update to the connection's hook URL. */
+    BotReceiveMode["Webhook"] = "webhook";
+    /** The worker asks the platform for updates (Telegram long polling). */
+    BotReceiveMode["Poll"] = "poll";
+    /** The worker holds a socket the platform pushes over (the Discord gateway). */
+    BotReceiveMode["Gateway"] = "gateway";
+})(BotReceiveMode || (BotReceiveMode = {}));
+/**
+ * Who answers a connection's platform calls.
+ *
+ * `mock` is the platform's API faithfully faked — no network, every call recorded as activity — so a
+ * preview, a test or an end-to-end run exercises the exact live path without a real bot.
+ */
+export var BotTransport;
+(function (BotTransport) {
+    BotTransport["Live"] = "live";
+    BotTransport["Mock"] = "mock";
+})(BotTransport || (BotTransport = {}));
+export var BotConnectionStatus;
+(function (BotConnectionStatus) {
+    /** Saved, not verified yet. */
+    BotConnectionStatus["Pending"] = "pending";
+    /** The platform accepted the credentials and the receiver is (or can be) running. */
+    BotConnectionStatus["Connected"] = "connected";
+    /** The last verification or receive failed — `lastError` says why. */
+    BotConnectionStatus["Failed"] = "failed";
+    /** Switched off by its owner; nothing is received or sent. */
+    BotConnectionStatus["Disabled"] = "disabled";
+})(BotConnectionStatus || (BotConnectionStatus = {}));
+/**
+ * What a bot can DO — the platform calls a handler makes, each recorded as one activity.
+ *
+ * `note` is the exception: it records an activity and makes no platform call, so every connection
+ * supports it and no platform descriptor lists it.
+ */
+export var BotActionKind;
+(function (BotActionKind) {
+    BotActionKind["Reply"] = "reply";
+    BotActionKind["Send"] = "send";
+    BotActionKind["Delete"] = "delete";
+    BotActionKind["Mute"] = "mute";
+    BotActionKind["Ban"] = "ban";
+    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) {
+    /** Whole words and whole phrases (consecutive words), Unicode-aware and case-insensitive. */
+    BotMatchMode["Word"] = "word";
+    /** A case-insensitive substring — also the mode for scripts written without spaces. */
+    BotMatchMode["Contains"] = "contains";
+})(BotMatchMode || (BotMatchMode = {}));
+export var BotUpdateKind;
+(function (BotUpdateKind) {
+    BotUpdateKind["Message"] = "message";
+    BotUpdateKind["Edited"] = "edited";
+    BotUpdateKind["Command"] = "command";
+    BotUpdateKind["Member"] = "member";
+})(BotUpdateKind || (BotUpdateKind = {}));
+export var BotChatKind;
+(function (BotChatKind) {
+    BotChatKind["Private"] = "private";
+    BotChatKind["Group"] = "group";
+    BotChatKind["Channel"] = "channel";
+})(BotChatKind || (BotChatKind = {}));
+/** The longest identifier (connection, rule, 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. */
+export const BOT_CREDENTIAL_MAX = 4096;
+/** How many credential keys one connection input may carry. */
+export const BOT_CREDENTIALS_MAX = 16;
+/** What a credential key may look like. */
+export const BOT_CREDENTIAL_KEY_PATTERN = '^[A-Za-z][A-Za-z0-9]{0,63}$';
+/** The longest free-text field of a simulated chat or sender (title, name, username). */
+export const BOT_NAME_MAX = 256;
+/** The most activity rows one read returns. */
+export const BOT_ACTIVITY_LIMIT_MAX = 200;
+/** The activity rows a read returns when it names no limit. */
+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.
+ */
+export const BOT_MANAGE_PERMISSION = 'bot--manage';
+/**
+ * What each platform needs and can do — the one table every layer reads: the panel draws the
+ * credential inputs from it, the server verifies and acts by it, generation picks actions from it.
+ *
+ * `actions` lists the platform CALLS a connection can make with its required credentials; an
+ * optional credential's `enables` adds more (Slack's admin `userToken` adds `delete`). `note` is never
+ * listed — it makes no platform call (`botPlatformHelper.actionsOf` answers the full set).
+ */
+export const BOT_PLATFORMS = Object.freeze({
+    [BotPlatform.Telegram]: Object.freeze({
+        platform: BotPlatform.Telegram,
+        title: 'Telegram',
+        credentials: Object.freeze([
+            Object.freeze({ key: 'token', secret: true, required: true }),
+        ]),
+        receive: Object.freeze([BotReceiveMode.Webhook, BotReceiveMode.Poll]),
+        actions: Object.freeze([
+            BotActionKind.Reply, BotActionKind.Send, BotActionKind.Delete, BotActionKind.Mute, BotActionKind.Ban,
+            BotActionKind.React,
+        ]),
+        setup: 'auto',
+        docs: 'https://core.telegram.org/bots/tutorial#obtain-your-bot-token',
+    }),
+    [BotPlatform.WhatsApp]: Object.freeze({
+        platform: BotPlatform.WhatsApp,
+        title: 'WhatsApp',
+        credentials: Object.freeze([
+            Object.freeze({ key: 'accessToken', secret: true, required: true }),
+            Object.freeze({ key: 'phoneNumberId', secret: false, required: true }),
+            Object.freeze({ key: 'appSecret', secret: true, required: true }),
+            Object.freeze({ key: 'verifyToken', secret: true, required: true, generated: true }),
+        ]),
+        receive: Object.freeze([BotReceiveMode.Webhook]),
+        actions: Object.freeze([BotActionKind.Reply, BotActionKind.Send, BotActionKind.React]),
+        setup: 'manual',
+        docs: 'https://developers.facebook.com/docs/whatsapp/cloud-api/get-started',
+    }),
+    [BotPlatform.Discord]: Object.freeze({
+        platform: BotPlatform.Discord,
+        title: 'Discord',
+        credentials: Object.freeze([
+            Object.freeze({ key: 'token', secret: true, required: true }),
+            Object.freeze({ key: 'applicationId', secret: false, required: true }),
+        ]),
+        receive: Object.freeze([BotReceiveMode.Gateway]),
+        actions: Object.freeze([
+            BotActionKind.Reply, BotActionKind.Send, BotActionKind.Delete, BotActionKind.Mute, BotActionKind.Ban,
+            BotActionKind.React,
+        ]),
+        setup: 'auto',
+        docs: 'https://discord.com/developers/docs/quick-start/getting-started',
+    }),
+    [BotPlatform.Slack]: Object.freeze({
+        platform: BotPlatform.Slack,
+        title: 'Slack',
+        credentials: Object.freeze([
+            Object.freeze({ key: 'botToken', secret: true, required: true }),
+            Object.freeze({ key: 'signingSecret', secret: true, required: true }),
+            Object.freeze({ key: 'userToken', secret: true, required: false, enables: Object.freeze([BotActionKind.Delete]) }),
+        ]),
+        receive: Object.freeze([BotReceiveMode.Webhook]),
+        actions: Object.freeze([BotActionKind.Reply, BotActionKind.Send, BotActionKind.React]),
+        setup: 'manual',
+        docs: 'https://api.slack.com/apis/events-api',
+    }),
+});
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"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"}

package/build/consts.local.d.ts

@@ -0,0 +1,13 @@
+/**
+ * One token of `word` matching: letters, combining marks, digits and `_`. Marks are part of the word
+ * (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. */
+export declare const BOT_SPACE_PATTERN: RegExp;
+/**
+ * A `/command`, optionally addressed `@ToBot`, ending at whitespace or at the end of the text, then
+ * its arguments.
+ */
+export declare const BOT_COMMAND_PATTERN: RegExp;
+//# sourceMappingURL=consts.local.d.ts.map