chatwoot-router 0.1.0 → 0.3.0

package/lib/packages/chatwoot-router/scripts/store-config.js

@@ -92,18 +92,16 @@ var reconcileSchema = z.strictObject({
 var accountId = z2.string().regex(/^[1-9]\d*$/, "must be a Chatwoot account id").refine((value) => Number.isSafeInteger(Number(value)), "must be a safe integer");
 var configSchema = z2.strictObject({
   chatwoot: z2.strictObject({ baseUrl: z2.url({ protocol: /^https?$/ }) }),
-  reconcile: reconcileSchema,
-  startAfterConversationId: z2.record(accountId, z2.number().int().min(0)).default({}),
-  subrequestBudget: z2.number().int().min(20).max(1e3).default(45),
+  subrequestBudget: z2.number().int().min(45).max(1e3).default(45),
   routing: z2.strictObject({
+    /** TypeSafe's System One API (/v1/systemone), or another deployment such as a proxy or gateway. */
+    endpoint: z2.url({ protocol: /^https$/ }).default("https://api.typesafe.ai/v1/systemone"),
+    /** Model sent to TypeSafe's System One API; Jev by default. */
     model: z2.string().min(1).default("jev-1.13.0"),
     /** Jev's probability an answer needs before it is applied. */
     minConfidence: z2.number().min(0.5).max(1).default(0.7),
-    /**
-     * Snooze a ticket Jev cannot assign yet, and in which the customer asked for nothing yet, until
-     * their next message (see src/routing.ts).
-     */
-    snoozeUnclear: z2.boolean().default(false),
+    /** The account's native Chatwoot agent bot. */
+    botIds: z2.record(accountId, z2.number().int().positive()),
     /** Per Chatwoot account id: the owners Jev chooses from, by a short name. */
     accounts: z2.record(
       accountId,
@@ -135,7 +133,7 @@ var configSchema = z2.strictObject({
           covers: z2.string().min(1).max(1e3),
           /**
            * Short code of the account's Chatwoot canned response sent to the customer once, as
-           * the account's agent bot (CHATWOOT_BOT_TOKENS). None is sent while it does not exist.
+           * the account's agent bot (CHATWOOT_AGENT_BOT_TOKENS). Missing responses hand off to people.
            */
           cannedResponse: z2.string().trim().min(1).max(255).optional(),
           /**
@@ -148,23 +146,26 @@ var configSchema = z2.strictObject({
       )
     ).optional()
   })
-}).refine((config) => Object.keys(config.startAfterConversationId).every((id) => config.routing.accounts[id]), {
-  path: ["startAfterConversationId"],
-  message: "must only name routed accounts"
-}).refine((config) => Object.keys(config.routing?.kinds ?? {}).every((id) => config.routing?.accounts[id]), {
+}).refine(
+  (config) => {
+    const accounts = Object.keys(config.routing.accounts);
+    return accounts.length > 0 && accounts.length === Object.keys(config.routing.botIds).length && accounts.every((id) => config.routing.botIds[id] !== void 0);
+  },
+  { path: ["routing", "botIds"], message: "must name exactly the routed accounts" }
+).refine((config) => Object.keys(config.routing.kinds ?? {}).every((id) => config.routing.accounts[id]), {
   path: ["routing", "kinds"],
   message: "must only name routed accounts"
 }).refine(
-  (config) => Object.values(config.routing?.kinds ?? {}).every(
-    (kinds) => Object.keys(kinds).every((kind) => !Object.hasOwn(config.routing?.topics ?? {}, kind))
+  (config) => Object.values(config.routing.kinds ?? {}).every(
+    (kinds) => Object.keys(kinds).every((kind) => !Object.hasOwn(config.routing.topics ?? {}, kind))
   ),
   { path: ["routing", "kinds"], message: "a kind cannot be named as a topic: they are labels of two families" }
 );
 var secretsSchema = z2.object({
   CHATWOOT_TOKEN: z2.string().min(1),
-  CHATWOOT_WEBHOOK_SECRETS: jsonRecord,
+  CHATWOOT_AGENT_BOT_SECRETS: jsonRecord,
   TYPESAFE_API_KEY: z2.string().min(1),
-  CHATWOOT_BOT_TOKENS: jsonRecord.default({})
+  CHATWOOT_AGENT_BOT_TOKENS: jsonRecord
 });
 
 // scripts/stored-config.ts

package/lib/packages/chatwoot-router/scripts/stored-config.js

@@ -44,18 +44,16 @@ var reconcileSchema = z.strictObject({
 var accountId = z2.string().regex(/^[1-9]\d*$/, "must be a Chatwoot account id").refine((value) => Number.isSafeInteger(Number(value)), "must be a safe integer");
 var configSchema = z2.strictObject({
   chatwoot: z2.strictObject({ baseUrl: z2.url({ protocol: /^https?$/ }) }),
-  reconcile: reconcileSchema,
-  startAfterConversationId: z2.record(accountId, z2.number().int().min(0)).default({}),
-  subrequestBudget: z2.number().int().min(20).max(1e3).default(45),
+  subrequestBudget: z2.number().int().min(45).max(1e3).default(45),
   routing: z2.strictObject({
+    /** TypeSafe's System One API (/v1/systemone), or another deployment such as a proxy or gateway. */
+    endpoint: z2.url({ protocol: /^https$/ }).default("https://api.typesafe.ai/v1/systemone"),
+    /** Model sent to TypeSafe's System One API; Jev by default. */
     model: z2.string().min(1).default("jev-1.13.0"),
     /** Jev's probability an answer needs before it is applied. */
     minConfidence: z2.number().min(0.5).max(1).default(0.7),
-    /**
-     * Snooze a ticket Jev cannot assign yet, and in which the customer asked for nothing yet, until
-     * their next message (see src/routing.ts).
-     */
-    snoozeUnclear: z2.boolean().default(false),
+    /** The account's native Chatwoot agent bot. */
+    botIds: z2.record(accountId, z2.number().int().positive()),
     /** Per Chatwoot account id: the owners Jev chooses from, by a short name. */
     accounts: z2.record(
       accountId,
@@ -87,7 +85,7 @@ var configSchema = z2.strictObject({
           covers: z2.string().min(1).max(1e3),
           /**
            * Short code of the account's Chatwoot canned response sent to the customer once, as
-           * the account's agent bot (CHATWOOT_BOT_TOKENS). None is sent while it does not exist.
+           * the account's agent bot (CHATWOOT_AGENT_BOT_TOKENS). Missing responses hand off to people.
            */
           cannedResponse: z2.string().trim().min(1).max(255).optional(),
           /**
@@ -100,23 +98,26 @@ var configSchema = z2.strictObject({
       )
     ).optional()
   })
-}).refine((config) => Object.keys(config.startAfterConversationId).every((id) => config.routing.accounts[id]), {
-  path: ["startAfterConversationId"],
-  message: "must only name routed accounts"
-}).refine((config) => Object.keys(config.routing?.kinds ?? {}).every((id) => config.routing?.accounts[id]), {
+}).refine(
+  (config) => {
+    const accounts = Object.keys(config.routing.accounts);
+    return accounts.length > 0 && accounts.length === Object.keys(config.routing.botIds).length && accounts.every((id) => config.routing.botIds[id] !== void 0);
+  },
+  { path: ["routing", "botIds"], message: "must name exactly the routed accounts" }
+).refine((config) => Object.keys(config.routing.kinds ?? {}).every((id) => config.routing.accounts[id]), {
   path: ["routing", "kinds"],
   message: "must only name routed accounts"
 }).refine(
-  (config) => Object.values(config.routing?.kinds ?? {}).every(
-    (kinds) => Object.keys(kinds).every((kind) => !Object.hasOwn(config.routing?.topics ?? {}, kind))
+  (config) => Object.values(config.routing.kinds ?? {}).every(
+    (kinds) => Object.keys(kinds).every((kind) => !Object.hasOwn(config.routing.topics ?? {}, kind))
   ),
   { path: ["routing", "kinds"], message: "a kind cannot be named as a topic: they are labels of two families" }
 );
 var secretsSchema = z2.object({
   CHATWOOT_TOKEN: z2.string().min(1),
-  CHATWOOT_WEBHOOK_SECRETS: jsonRecord,
+  CHATWOOT_AGENT_BOT_SECRETS: jsonRecord,
   TYPESAFE_API_KEY: z2.string().min(1),
-  CHATWOOT_BOT_TOKENS: jsonRecord.default({})
+  CHATWOOT_AGENT_BOT_TOKENS: jsonRecord
 });
 
 // scripts/stored-config.ts

package/lib/packages/chatwoot-router/src/config.d.ts

@@ -4,16 +4,12 @@ export declare const configSchema: z.ZodObject<{
     chatwoot: z.ZodObject<{
         baseUrl: z.ZodURL;
     }, z.core.$strict>;
-    reconcile: z.ZodPrefault<z.ZodObject<{
-        lookbackSeconds: z.ZodDefault<z.ZodNumber>;
-        maxCatchUpSeconds: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strict>>;
-    startAfterConversationId: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     subrequestBudget: z.ZodDefault<z.ZodNumber>;
     routing: z.ZodObject<{
+        endpoint: z.ZodDefault<z.ZodURL>;
         model: z.ZodDefault<z.ZodString>;
         minConfidence: z.ZodDefault<z.ZodNumber>;
-        snoozeUnclear: z.ZodDefault<z.ZodBoolean>;
+        botIds: z.ZodRecord<z.ZodString, z.ZodNumber>;
         accounts: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
             assignee: z.ZodNumber;
             covers: z.ZodString;
@@ -31,16 +27,15 @@ export declare const configSchema: z.ZodObject<{
 }, z.core.$strict>;
 export declare const secretsSchema: z.ZodObject<{
     CHATWOOT_TOKEN: z.ZodString;
-    CHATWOOT_WEBHOOK_SECRETS: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<unknown, string>>, z.ZodRecord<z.ZodString, z.ZodString>>;
+    CHATWOOT_AGENT_BOT_SECRETS: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<unknown, string>>, z.ZodRecord<z.ZodString, z.ZodString>>;
     TYPESAFE_API_KEY: z.ZodString;
-    CHATWOOT_BOT_TOKENS: z.ZodDefault<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<unknown, string>>, z.ZodRecord<z.ZodString, z.ZodString>>>;
+    CHATWOOT_AGENT_BOT_TOKENS: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<unknown, string>>, z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
 type Config = z.infer<typeof configSchema>;
 type Secrets = z.infer<typeof secretsSchema>;
 export interface Settings {
     config: Config;
     secrets: Secrets;
-    botToken(accountId: number): string | undefined;
 }
 export declare function parseSettings(rawConfig: unknown, rawSecrets: object): Settings;
 export declare function buildSettings(config: Config, secrets: Secrets): Settings;

package/lib/packages/chatwoot-router/src/coordinator.d.ts

@@ -0,0 +1,10 @@
+import { DurableObject } from "cloudflare:workers";
+import type { Env } from "./env.ts";
+export declare const COORDINATOR_NAME = "global";
+/** Lists one page per alarm. Conversation state belongs exclusively to the conversation's Router. */
+export declare class Coordinator extends DurableObject<Env> {
+    private readonly store;
+    constructor(ctx: DurableObjectState, env: Env);
+    requestSweep(): Promise<void>;
+    alarm(): Promise<void>;
+}

package/lib/packages/chatwoot-router/src/env.d.ts

@@ -1,9 +1,11 @@
 import type { ConfigEnv } from "../../../shared/settings.ts";
+import type { Coordinator } from "./coordinator.ts";
 import type { Router } from "./router.ts";
 export interface Env extends ConfigEnv {
+    COORDINATOR: DurableObjectNamespace<Coordinator>;
     ROUTER: DurableObjectNamespace<Router>;
     CHATWOOT_TOKEN: string;
-    CHATWOOT_WEBHOOK_SECRETS: string;
+    CHATWOOT_AGENT_BOT_SECRETS: string;
     TYPESAFE_API_KEY: string;
-    CHATWOOT_BOT_TOKENS?: string;
+    CHATWOOT_AGENT_BOT_TOKENS: string;
 }

package/lib/packages/chatwoot-router/src/index.d.ts

@@ -4,4 +4,5 @@ declare const _default: {
     scheduled(_controller: ScheduledController, env: Env, context: ExecutionContext<unknown>): Promise<void>;
 };
 export default _default;
+export { Coordinator } from "./coordinator.ts";
 export { Router } from "./router.ts";