@hera-al/server 1.6.1

package/dist/config.d.ts

@@ -0,0 +1,267 @@
+import { z } from "zod";
+/** Returns the resolved GMAB_PATH (home by default). */
+export declare function getGmabPath(): string;
+/** Returns the data directory ({gmabPath}/data/). */
+export declare function getDataDir(): string;
+/** Returns the path for .nostromo-key ({gmabPath}/data/.nostromo-key). */
+export declare function getNostromoKeyPath(): string;
+/**
+ * Rotate config backups before saving.
+ * Keeps up to 5 backups: .backup1 (oldest) → .backup5 (newest).
+ */
+export declare function backupConfig(configPath: string): void;
+declare const AppConfigSchema: z.ZodObject<{
+    gmabPath: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    host: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    logLevel: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        error: "error";
+    }>>>;
+    verboseDebugLogs: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timezone: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    fastProxyUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    channels: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        telegram: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            accounts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                botToken: z.ZodString;
+                dmPolicy: z.ZodDefault<z.ZodEnum<{
+                    open: "open";
+                    token: "token";
+                    allowlist: "allowlist";
+                }>>;
+                allowFrom: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+        whatsapp: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            accounts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strip>>>;
+        discord: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            accounts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strip>>>;
+        slack: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            accounts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strip>>>;
+        signal: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            accounts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strip>>>;
+        msteams: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            accounts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strip>>>;
+        googlechat: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            accounts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strip>>>;
+        line: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            accounts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strip>>>;
+        matrix: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            accounts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, z.core.$strip>>>;
+        responses: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            port: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    models: z.ZodDefault<z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        types: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            internal: "internal";
+            external: "external";
+            "env-var": "env-var";
+        }>>>>;
+        proxy: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            "not-used": "not-used";
+            direct: "direct";
+            proxied: "proxied";
+        }>>>;
+        fastUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        fastProxyApiKey: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        apiKey: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        baseURL: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        useEnvVar: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>>>>;
+    stt: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        provider: z.ZodDefault<z.ZodString>;
+        "openai-whisper": z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            modelRef: z.ZodDefault<z.ZodString>;
+            model: z.ZodDefault<z.ZodString>;
+            language: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>>;
+        "local-whisper": z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            binaryPath: z.ZodDefault<z.ZodString>;
+            model: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    tts: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        provider: z.ZodDefault<z.ZodEnum<{
+            edge: "edge";
+            openai: "openai";
+            elevenlabs: "elevenlabs";
+        }>>;
+        maxTextLength: z.ZodDefault<z.ZodNumber>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        edge: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            voice: z.ZodDefault<z.ZodString>;
+            lang: z.ZodDefault<z.ZodString>;
+            outputFormat: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>>;
+        openai: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            modelRef: z.ZodDefault<z.ZodString>;
+            model: z.ZodDefault<z.ZodString>;
+            voice: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>>;
+        elevenlabs: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            modelRef: z.ZodDefault<z.ZodString>;
+            voiceId: z.ZodDefault<z.ZodString>;
+            modelId: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    memory: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        recallStrategy: z.ZodDefault<z.ZodEnum<{
+            "builtin-only": "builtin-only";
+            search: "search";
+        }>>;
+        search: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            embeddingModel: z.ZodDefault<z.ZodString>;
+            embeddingDimensions: z.ZodDefault<z.ZodNumber>;
+            modelRef: z.ZodDefault<z.ZodString>;
+            prefixQuery: z.ZodDefault<z.ZodString>;
+            prefixDocument: z.ZodDefault<z.ZodString>;
+            updateDebounceMs: z.ZodDefault<z.ZodNumber>;
+            embedIntervalMs: z.ZodDefault<z.ZodNumber>;
+            maxResults: z.ZodDefault<z.ZodNumber>;
+            maxSnippetChars: z.ZodDefault<z.ZodNumber>;
+            maxInjectedChars: z.ZodDefault<z.ZodNumber>;
+            rrfK: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    agent: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        model: z.ZodDefault<z.ZodString>;
+        mainFallback: z.ZodDefault<z.ZodString>;
+        maxTurns: z.ZodDefault<z.ZodNumber>;
+        permissionMode: z.ZodDefault<z.ZodString>;
+        sessionTTL: z.ZodDefault<z.ZodNumber>;
+        queueMode: z.ZodDefault<z.ZodEnum<{
+            queue: "queue";
+            collect: "collect";
+            steer: "steer";
+        }>>;
+        queueDebounceMs: z.ZodDefault<z.ZodNumber>;
+        queueCap: z.ZodDefault<z.ZodNumber>;
+        queueDropPolicy: z.ZodDefault<z.ZodEnum<{
+            old: "old";
+            new: "new";
+            summarize: "summarize";
+        }>>;
+        allowedTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        disallowedTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        mcpServers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$loose>>>;
+        workspacePath: z.ZodDefault<z.ZodString>;
+        builtinCoderSkill: z.ZodDefault<z.ZodBoolean>;
+        settingSources: z.ZodDefault<z.ZodEnum<{
+            nothing: "nothing";
+            user: "user";
+            project: "project";
+            both: "both";
+        }>>;
+        customSubAgents: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            prompt: z.ZodString;
+            model: z.ZodDefault<z.ZodEnum<{
+                sonnet: "sonnet";
+                opus: "opus";
+                haiku: "haiku";
+                inherit: "inherit";
+            }>>;
+            tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            expandContext: z.ZodDefault<z.ZodBoolean>;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        plugins: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            path: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        inflightTyping: z.ZodDefault<z.ZodBoolean>;
+        autoApproveTools: z.ZodDefault<z.ZodBoolean>;
+        autoRenew: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    cron: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        isolated: z.ZodDefault<z.ZodBoolean>;
+        broadcastEvents: z.ZodDefault<z.ZodBoolean>;
+        storePath: z.ZodDefault<z.ZodString>;
+        heartbeat: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            every: z.ZodDefault<z.ZodNumber>;
+            channel: z.ZodDefault<z.ZodString>;
+            chatId: z.ZodDefault<z.ZodString>;
+            message: z.ZodDefault<z.ZodString>;
+            ackMaxChars: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    nostromo: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        port: z.ZodDefault<z.ZodNumber>;
+        basePath: z.ZodDefault<z.ZodString>;
+        configCheckInterval: z.ZodDefault<z.ZodNumber>;
+        autoRestart: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    browser: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        controlPort: z.ZodDefault<z.ZodNumber>;
+        headless: z.ZodDefault<z.ZodBoolean>;
+        noSandbox: z.ZodDefault<z.ZodBoolean>;
+        attachOnly: z.ZodDefault<z.ZodBoolean>;
+        executablePath: z.ZodOptional<z.ZodString>;
+        remoteCdpTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        profiles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            cdpPort: z.ZodOptional<z.ZodNumber>;
+            cdpUrl: z.ZodOptional<z.ZodString>;
+            color: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type RawAppConfig = z.infer<typeof AppConfigSchema>;
+export type AppConfig = RawAppConfig & {
+    gmabPath: string;
+    dataDir: string;
+    dbPath: string;
+    memoryDir: string;
+    cronStorePath: string;
+};
+export declare function loadConfig(configPath?: string): AppConfig;
+/**
+ * Load and parse config.yaml without env var interpolation or Zod validation.
+ * Returns the raw parsed YAML so ${VAR_NAME} strings stay intact.
+ */
+export declare function loadRawConfig(configPath?: string): any;
+/**
+ * Resolve a model name to its actual model ID using the models registry.
+ * If the name matches a registry entry, returns the entry's id.
+ * Otherwise returns the raw value as-is (backwards compat / direct id usage).
+ */
+export declare function resolveModelId(config: AppConfig, name: string): string;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.js

@@ -0,0 +1 @@
+import{readFileSync as e,writeFileSync as t,existsSync as a,mkdirSync as o,renameSync as n,unlinkSync as l}from"node:fs";import{resolve as r,join as s}from"node:path";import{homedir as i}from"node:os";import{config as u}from"dotenv";import{parse as d,stringify as c}from"yaml";import{z as f}from"zod";import{BrowserConfigSchema as p}from"@hera-al/browser-server/config";import{createLogger as m}from"./utils/logger.js";const b=m("Config");function g(e){return"~"===e||e.startsWith("~/")?e.replace("~",i()):e}let h=g(process.env.GMAB_PATH??"~/gmab"),y=s(h,"data");export function getGmabPath(){return h}export function getDataDir(){return y}export function getNostromoKeyPath(){return s(y,".nostromo-key")}export function backupConfig(o){if(a(o))try{const r=e=>`${o}.backup${e}`;a(r(1))&&l(r(1));for(let e=2;e<=5;e++)a(r(e))&&n(r(e),r(e-1));t(r(5),e(o)),b.debug(`Config backup created: ${r(5)}`)}catch(e){b.warn(`Failed to create config backup: ${e}`)}}const v=f.record(f.string(),f.any()),x=f.object({botToken:f.string(),dmPolicy:f.enum(["open","token","allowlist"]).default("allowlist"),allowFrom:f.array(f.union([f.string(),f.number()])).default([])}),w=f.object({enabled:f.boolean().default(!1),accounts:f.record(f.string(),x).default({})}),P=f.object({enabled:f.boolean().default(!1),accounts:v.default({})}),k=f.object({enabled:f.boolean().default(!0),port:f.number().default(3004)}),j=f.object({telegram:w.optional().default({enabled:!1,accounts:{}}),whatsapp:P.optional().default({enabled:!1,accounts:{}}),discord:P.optional().default({enabled:!1,accounts:{}}),slack:P.optional().default({enabled:!1,accounts:{}}),signal:P.optional().default({enabled:!1,accounts:{}}),msteams:P.optional().default({enabled:!1,accounts:{}}),googlechat:P.optional().default({enabled:!1,accounts:{}}),line:P.optional().default({enabled:!1,accounts:{}}),matrix:P.optional().default({enabled:!1,accounts:{}}),responses:k.optional().default({enabled:!0,port:3e3})}),M=f.object({modelRef:f.string().default(""),model:f.string().default("whisper-1"),language:f.string().default("")}),S=f.object({binaryPath:f.string().default("whisper"),model:f.string().default("base")}),R=f.object({enabled:f.boolean().default(!1),provider:f.string().default("openai-whisper"),"openai-whisper":M.optional().default({modelRef:"",model:"whisper-1",language:""}),"local-whisper":S.optional().default({binaryPath:"whisper",model:"base"})}),T=f.object({voice:f.string().default("en-US-MichelleNeural"),lang:f.string().default("en-US"),outputFormat:f.string().default("audio-24khz-48kbitrate-mono-mp3")}),C=f.object({modelRef:f.string().default(""),model:f.string().default("gpt-4o-mini-tts"),voice:f.string().default("alloy")}),A=f.object({modelRef:f.string().default(""),voiceId:f.string().default("pMsXgVXv3BLzUgSXRplE"),modelId:f.string().default("eleven_multilingual_v2")}),U=f.object({enabled:f.boolean().default(!1),provider:f.enum(["edge","openai","elevenlabs"]).default("openai"),maxTextLength:f.number().default(4096),timeoutMs:f.number().default(3e4),edge:T.optional().default({voice:"en-US-MichelleNeural",lang:"en-US",outputFormat:"audio-24khz-48kbitrate-mono-mp3"}),openai:C.optional().default({modelRef:"",model:"gpt-4o-mini-tts",voice:"alloy"}),elevenlabs:A.optional().default({modelRef:"",voiceId:"pMsXgVXv3BLzUgSXRplE",modelId:"eleven_multilingual_v2"})}),z=f.object({enabled:f.boolean().default(!1),embeddingModel:f.string().default("text-embedding-3-small"),embeddingDimensions:f.number().default(1536),modelRef:f.string().default(""),prefixQuery:f.string().default(""),prefixDocument:f.string().default(""),updateDebounceMs:f.number().default(3e3),embedIntervalMs:f.number().default(3e5),maxResults:f.number().default(6),maxSnippetChars:f.number().default(700),maxInjectedChars:f.number().default(4e3),rrfK:f.number().default(60)}),D={enabled:!1,embeddingModel:"text-embedding-3-small",embeddingDimensions:1536,modelRef:"",prefixQuery:"",prefixDocument:"",updateDebounceMs:3e3,embedIntervalMs:3e5,maxResults:6,maxSnippetChars:700,maxInjectedChars:4e3,rrfK:60},I=f.object({enabled:f.boolean().default(!0),recallStrategy:f.enum(["builtin-only","search"]).default("builtin-only"),search:z.optional().default(D)}),L=f.object({command:f.string(),args:f.array(f.string()).optional(),env:f.record(f.string(),f.string()).optional()}).passthrough(),E=f.object({id:f.string(),name:f.string(),types:f.array(f.enum(["internal","external","env-var"])).optional().default(["external"]),proxy:f.enum(["not-used","direct","proxied"]).optional().default("not-used"),fastUrl:f.string().optional().default(""),fastProxyApiKey:f.string().optional().default(""),apiKey:f.string().optional().default(""),baseURL:f.string().optional().default(""),useEnvVar:f.string().optional().default("")}),F=[{id:"claude-opus-4-6",name:"Claude Opus",types:["internal"],proxy:"not-used",fastUrl:"",fastProxyApiKey:"",apiKey:"",baseURL:"",useEnvVar:""},{id:"claude-sonnet-4-6",name:"Claude Sonnet",types:["internal"],proxy:"not-used",fastUrl:"",fastProxyApiKey:"",apiKey:"",baseURL:"",useEnvVar:""},{id:"claude-haiku-3-5-20241022",name:"Claude Haiku",types:["internal"],proxy:"not-used",fastUrl:"",fastProxyApiKey:"",apiKey:"",baseURL:"",useEnvVar:""}],K=f.array(E).default(F),_=f.object({name:f.string(),path:f.string(),description:f.string().default(""),enabled:f.boolean().default(!1)}),q=f.object({name:f.string(),description:f.string(),prompt:f.string(),model:f.enum(["sonnet","opus","haiku","inherit"]).default("inherit"),tools:f.array(f.string()).default(["Read","Write","Edit","Glob","Grep","WebSearch","WebFetch"]),expandContext:f.boolean().default(!1),enabled:f.boolean().default(!1)}),G=f.object({model:f.string().default("claude-opus-4-6"),mainFallback:f.string().default(""),maxTurns:f.number().default(50),permissionMode:f.string().default("bypassPermissions"),sessionTTL:f.number().default(3600),queueMode:f.enum(["queue","collect","steer"]).default("steer"),queueDebounceMs:f.number().default(1500),queueCap:f.number().default(20),queueDropPolicy:f.enum(["old","new","summarize"]).default("summarize"),allowedTools:f.array(f.string()).default([]),disallowedTools:f.array(f.string()).default([]),mcpServers:f.record(f.string(),L).default({}),workspacePath:f.string().default("./workspace"),builtinCoderSkill:f.boolean().default(!1),settingSources:f.enum(["nothing","user","project","both"]).default("project"),customSubAgents:f.array(q).default([]),plugins:f.array(_).default([]),inflightTyping:f.boolean().default(!0),autoApproveTools:f.boolean().default(!0),autoRenew:f.number().default(0)}),X={enabled:!1,provider:"openai",maxTextLength:4096,timeoutMs:3e4,edge:{voice:"en-US-MichelleNeural",lang:"en-US",outputFormat:"audio-24khz-48kbitrate-mono-mp3"},openai:{modelRef:"",model:"gpt-4o-mini-tts",voice:"alloy"},elevenlabs:{modelRef:"",voiceId:"pMsXgVXv3BLzUgSXRplE",modelId:"eleven_multilingual_v2"}},$={enabled:!0,recallStrategy:"builtin-only",dir:"",search:D},B={model:"claude-opus-4-6",mainFallback:"",maxTurns:50,permissionMode:"bypassPermissions",sessionTTL:3600,queueMode:"steer",queueDebounceMs:1500,queueCap:20,queueDropPolicy:"summarize",allowedTools:[],disallowedTools:[],mcpServers:{},workspacePath:"./workspace",builtinCoderSkill:!1,settingSources:"project",customSubAgents:[],plugins:[],inflightTyping:!0,autoApproveTools:!0,autoRenew:0},W=f.object({enabled:f.boolean().default(!1),every:f.number().default(18e5),channel:f.string().default(""),chatId:f.string().default(""),message:f.string().default(""),ackMaxChars:f.number().default(300)}),V={enabled:!1,every:18e5,channel:"",chatId:"",message:"",ackMaxChars:300},H=f.object({enabled:f.boolean().default(!0),isolated:f.boolean().default(!0),broadcastEvents:f.boolean().default(!1),storePath:f.string().default(""),heartbeat:W.optional().default(V)}),N={enabled:!0,isolated:!0,broadcastEvents:!1,storePath:"",heartbeat:V},O=f.object({enabled:f.boolean().default(!0),port:f.number().default(3001),basePath:f.string().default("/nostromo"),configCheckInterval:f.number().default(5),autoRestart:f.boolean().default(!0)}),Q={enabled:!0,port:3001,basePath:"/nostromo",configCheckInterval:5,autoRestart:!0},Z=f.object({gmabPath:f.string().optional().default("~/gmab"),host:f.string().optional().default("127.0.0.1"),logLevel:f.enum(["debug","info","warn","error"]).optional().default("info"),verboseDebugLogs:f.boolean().optional().default(!0),timezone:f.string().optional().default(""),fastProxyUrl:f.string().optional().default("http://localhost:4181"),channels:j.optional().default({telegram:{enabled:!1,accounts:{}},whatsapp:{enabled:!1,accounts:{}},discord:{enabled:!1,accounts:{}},slack:{enabled:!1,accounts:{}},signal:{enabled:!1,accounts:{}},msteams:{enabled:!1,accounts:{}},googlechat:{enabled:!1,accounts:{}},line:{enabled:!1,accounts:{}},matrix:{enabled:!1,accounts:{}},responses:{enabled:!0,port:3004}}),models:K.optional().default(F),stt:R.optional().default({enabled:!1,provider:"openai-whisper","openai-whisper":{modelRef:"",model:"whisper-1",language:""},"local-whisper":{binaryPath:"whisper",model:"base"}}),tts:U.optional().default(X),memory:I.optional().default($),agent:G.optional().default(B),cron:H.optional().default(N),nostromo:O.optional().default(Q),browser:p.optional().default({enabled:!1,controlPort:3002,headless:!1,noSandbox:!1,attachOnly:!1,remoteCdpTimeoutMs:1500,profiles:{default:{cdpPort:9222,color:"#FF4500"}}})});function J(e){const t=function(e){const t=new Set,a=/\$\{([^}]+)\}/g;let o;for(;null!==(o=a.exec(e));)t.add(o[1]);return Array.from(t)}(e),a=t.filter(e=>!process.env[e]);a.length>0&&b.warn(`Missing environment variables referenced in config: ${a.join(", ")}. Add them to .env or export them before starting.`)}function Y(e){if("string"==typeof e)return e.replace(/\$\{([^}]+)\}/g,(e,t)=>process.env[t]??"");if(Array.isArray(e))return e.map(Y);if(null!==e&&"object"==typeof e){const t={};for(const[a,o]of Object.entries(e))t[a]=Y(o);return t}return e}const ee={channels:{responses:{enabled:!0,port:3004}},stt:{enabled:!1},tts:X,memory:$,agent:{...B,permissionMode:"bypassPermissions",allowedTools:["Read","Grep","Bash","WebSearch","Glob","Write","Edit","WebFetch","Task","Skill"]},cron:N,nostromo:Q};export function loadConfig(n){const l=n??r(process.cwd(),"config.yaml"),i=r(process.cwd(),".env");if(a(i)&&(u({path:i}),b.info(`Loaded .env from ${i}`)),!a(l)){const e="# GrabMeABeer Configuration\n# Configure channels and settings via Nostromo: http://localhost:3001\n\n"+c({gmabPath:"~/gmab",...ee});t(l,e,"utf-8")}const f=e(l,"utf-8");J(f);const p=Y(d(f)),m=Z.parse(p);if(h=process.env.GMAB_PATH?g(process.env.GMAB_PATH):g(m.gmabPath),y=s(h,"data"),o(y,{recursive:!0}),!m.timezone){m.timezone=Intl.DateTimeFormat().resolvedOptions().timeZone;try{const a=d(e(l,"utf-8"))??{};a.timezone=m.timezone,t(l,c(a),"utf-8"),b.info(`Timezone auto-detected and saved: ${m.timezone}`)}catch(e){}}return function(e){o(y,{recursive:!0});const t=process.env.WORKSPACE_PATH??e.agent.workspacePath;e.agent.workspacePath=r(g(t)),o(e.agent.workspacePath,{recursive:!0});const a=s(y,"cron");o(a,{recursive:!0});const n=e.cron.storePath.trim()?r(g(e.cron.storePath)):s(a,"jobs.json");return{...e,gmabPath:h,dataDir:y,dbPath:s(y,"core.db"),memoryDir:s(y,"memory"),cronStorePath:n}}(m)}export function loadRawConfig(t){const o=t??r(process.cwd(),"config.yaml");if(!a(o))return{};const n=e(o,"utf-8");return d(n)??{}}export function resolveModelId(e,t){if(!t)return t;const a=e.models?.find(e=>e.name===t);return a?a.id:t}

package/dist/cron/cron-service.d.ts

@@ -0,0 +1,57 @@
+import type { CronJob, CronJobCreate, CronJobPatch } from "./types.js";
+export type CronExecuteResult = {
+    response: string;
+    delivered: boolean;
+};
+export type CronServiceOpts = {
+    storePath: string;
+    enabled: boolean;
+    defaultTimezone?: string;
+    onExecute: (job: CronJob) => Promise<CronExecuteResult>;
+};
+export type CronStatusSummary = {
+    enabled: boolean;
+    storePath: string;
+    jobs: number;
+    nextWakeAtMs: number | null;
+};
+export declare class CronService {
+    private store;
+    private timer;
+    private running;
+    private op;
+    private readonly storePath;
+    private readonly enabled;
+    private readonly defaultTimezone;
+    private readonly onExecute;
+    constructor(opts: CronServiceOpts);
+    private locked;
+    private ensureLoaded;
+    private persist;
+    private computeJobNextRunAtMs;
+    private recomputeNextRuns;
+    private nextWakeAtMs;
+    private armTimer;
+    private stopTimer;
+    private onTimer;
+    private runDueJobs;
+    private executeJob;
+    start(): Promise<void>;
+    stop(): void;
+    status(): Promise<CronStatusSummary>;
+    list(opts?: {
+        includeDisabled?: boolean;
+    }): Promise<CronJob[]>;
+    add(input: CronJobCreate): Promise<CronJob>;
+    update(id: string, patch: CronJobPatch): Promise<CronJob>;
+    remove(id: string): Promise<{
+        ok: boolean;
+        removed: boolean;
+    }>;
+    run(id: string, mode?: "due" | "force"): Promise<{
+        ok: boolean;
+        ran: boolean;
+        reason?: string;
+    }>;
+}
+//# sourceMappingURL=cron-service.d.ts.map

package/dist/cron/cron-service.js

@@ -0,0 +1 @@
+import t from"node:crypto";import{computeNextRunAtMs as e}from"./schedule.js";import{loadCronStore as s,saveCronStore as n}from"./store.js";import{createLogger as a}from"../utils/logger.js";const i=a("Cron"),o=t=>t.then(()=>{},()=>{});export class CronService{store=null;timer=null;running=!1;op=Promise.resolve();storePath;enabled;defaultTimezone;onExecute;constructor(t){this.storePath=t.storePath,this.enabled=t.enabled,this.defaultTimezone=t.defaultTimezone||"",this.onExecute=t.onExecute}async locked(t){const e=o(this.op).then(t),s=o(e);return this.op=s,await e}async ensureLoaded(t){this.store&&!t?.forceReload||(this.store=await s(this.storePath))}async persist(){this.store&&await n(this.storePath,this.store)}computeJobNextRunAtMs(t,s){if(t.enabled){if("at"===t.schedule.kind){if("ok"===t.state.lastStatus&&t.state.lastRunAtMs)return;const e=new Date(t.schedule.at).getTime();return Number.isFinite(e)?e:void 0}return e(t.schedule,s,this.defaultTimezone)}}recomputeNextRuns(){if(!this.store)return;const t=Date.now();for(const e of this.store.jobs){if(e.state||(e.state={}),!e.enabled){e.state.nextRunAtMs=void 0,e.state.runningAtMs=void 0;continue}const s=e.state.runningAtMs;"number"==typeof s&&t-s>72e5&&(i.warn(`Clearing stuck running marker for job ${e.id}`),e.state.runningAtMs=void 0),e.state.nextRunAtMs=this.computeJobNextRunAtMs(e,t)}}nextWakeAtMs(){const t=(this.store?.jobs??[]).filter(t=>t.enabled&&"number"==typeof t.state.nextRunAtMs);if(0!==t.length)return t.reduce((t,e)=>Math.min(t,e.state.nextRunAtMs),t[0].state.nextRunAtMs)}armTimer(){if(this.timer&&clearTimeout(this.timer),this.timer=null,!this.enabled)return;const t=this.nextWakeAtMs();if(!t)return;const e=Math.max(t-Date.now(),0),s=Math.min(e,2147483647);this.timer=setTimeout(()=>{this.onTimer().catch(t=>{i.error(`Timer tick failed: ${t}`)})},s)}stopTimer(){this.timer&&clearTimeout(this.timer),this.timer=null}async onTimer(){if(!this.running){this.running=!0;try{await this.locked(async()=>{await this.ensureLoaded({forceReload:!0}),await this.runDueJobs(),this.recomputeNextRuns(),await this.persist()})}finally{this.running=!1,this.armTimer()}}}async runDueJobs(){if(!this.store)return;const t=Date.now(),e=this.store.jobs.filter(e=>{if(!e.enabled)return!1;if("number"==typeof e.state.runningAtMs)return!1;const s=e.state.nextRunAtMs;return"number"==typeof s&&t>=s});for(const t of e)await this.executeJob(t,{forced:!1})}async executeJob(t,e){const s=Date.now();t.state.runningAtMs=s,t.state.lastError=void 0;let n=!1;const a=async(e,a)=>{const i=Date.now();t.state.runningAtMs=void 0,t.state.lastRunAtMs=s,t.state.lastStatus=e,t.state.lastDurationMs=Math.max(0,i-s),t.state.lastError=a;const o="at"===t.schedule.kind&&"ok"===e&&!0===t.deleteAfterRun;o||("at"===t.schedule.kind&&"ok"===e?(t.enabled=!1,t.state.nextRunAtMs=void 0):t.enabled?t.state.nextRunAtMs=this.computeJobNextRunAtMs(t,i):t.state.nextRunAtMs=void 0),o&&this.store&&(this.store.jobs=this.store.jobs.filter(e=>e.id!==t.id),n=!0)};try{i.info(`Executing job "${t.name}" (${t.id})`);const e=(await this.onExecute(t)).delivered?"ok (delivered)":"ok (suppressed)";i.info(`Job "${t.name}" finished: ${e}`),await a("ok")}catch(e){i.error(`Job "${t.name}" failed: ${e}`),await a("error",String(e))}finally{t.updatedAtMs=Date.now(),e.forced||!t.enabled||n||(t.state.nextRunAtMs=this.computeJobNextRunAtMs(t,Date.now()))}}async start(){await this.locked(async()=>{this.enabled?(await this.ensureLoaded(),this.recomputeNextRuns(),await this.persist(),this.armTimer(),i.info(`Cron started (${this.store?.jobs.length??0} jobs, next wake: ${this.nextWakeAtMs()??"none"})`)):i.info("Cron disabled")})}stop(){this.stopTimer()}async status(){return await this.locked(async()=>(await this.ensureLoaded(),{enabled:this.enabled,storePath:this.storePath,jobs:this.store?.jobs.length??0,nextWakeAtMs:this.enabled?this.nextWakeAtMs()??null:null}))}async list(t){return await this.locked(async()=>{await this.ensureLoaded();const e=!0===t?.includeDisabled;return[...(this.store?.jobs??[]).filter(t=>e||t.enabled)].sort((t,e)=>(t.state.nextRunAtMs??0)-(e.state.nextRunAtMs??0))})}async add(e){return await this.locked(async()=>{await this.ensureLoaded();const s=Date.now(),n=t.randomUUID(),a="boolean"==typeof e.deleteAfterRun?e.deleteAfterRun:"at"===e.schedule.kind||void 0,o="boolean"!=typeof e.enabled||e.enabled,r="boolean"!=typeof e.isolated||e.isolated,d={id:n,name:e.name.trim()||"Untitled",description:e.description?.trim()||void 0,enabled:o,isolated:r,deleteAfterRun:a,suppressToken:e.suppressToken,createdAtMs:s,updatedAtMs:s,schedule:e.schedule,channel:e.channel,chatId:e.chatId,message:e.message,state:{...e.state}};return d.state.nextRunAtMs=this.computeJobNextRunAtMs(d,s),this.store?.jobs.push(d),await this.persist(),this.armTimer(),i.info(`Job added: "${d.name}" (${d.id}), next run: ${d.state.nextRunAtMs??"none"}`),d})}async update(t,e){return await this.locked(async()=>{await this.ensureLoaded();const s=this.store?.jobs.find(e=>e.id===t);if(!s)throw new Error(`Unknown cron job id: ${t}`);const n=Date.now();return"name"in e&&"string"==typeof e.name&&(s.name=e.name.trim()||s.name),"description"in e&&(s.description=e.description?.trim()||void 0),"boolean"==typeof e.enabled&&(s.enabled=e.enabled),"boolean"==typeof e.isolated&&(s.isolated=e.isolated),"boolean"==typeof e.deleteAfterRun&&(s.deleteAfterRun=e.deleteAfterRun),"boolean"==typeof e.suppressToken&&(s.suppressToken=e.suppressToken),e.schedule&&(s.schedule=e.schedule),"string"==typeof e.channel&&(s.channel=e.channel),"string"==typeof e.chatId&&(s.chatId=e.chatId),"string"==typeof e.message&&(s.message=e.message),e.state&&(s.state={...s.state,...e.state}),s.updatedAtMs=n,s.enabled?s.state.nextRunAtMs=this.computeJobNextRunAtMs(s,n):(s.state.nextRunAtMs=void 0,s.state.runningAtMs=void 0),await this.persist(),this.armTimer(),s})}async remove(t){return await this.locked(async()=>{if(await this.ensureLoaded(),!this.store)return{ok:!1,removed:!1};const e=this.store.jobs.length;this.store.jobs=this.store.jobs.filter(e=>e.id!==t);const s=this.store.jobs.length!==e;return await this.persist(),this.armTimer(),s&&i.info(`Job removed: ${t}`),{ok:!0,removed:s}})}async run(t,e){return await this.locked(async()=>{await this.ensureLoaded();const s=this.store?.jobs.find(e=>e.id===t);if(!s)throw new Error(`Unknown cron job id: ${t}`);const n=Date.now(),a="force"===e;return a||s.enabled&&"number"==typeof s.state.nextRunAtMs&&n>=s.state.nextRunAtMs?(await this.executeJob(s,{forced:a}),await this.persist(),this.armTimer(),{ok:!0,ran:!0}):{ok:!0,ran:!1,reason:"not-due"}})}}

package/dist/cron/heartbeat-token.d.ts

@@ -0,0 +1,29 @@
+export declare const HEARTBEAT_TOKEN = "HEARTBEAT_OK";
+/**
+ * Check if HEARTBEAT.md content is "effectively empty" — no actionable tasks.
+ * Skipping heartbeat when the file is empty saves API calls.
+ *
+ * A file is considered effectively empty if it contains only:
+ * - Whitespace / empty lines
+ * - Markdown headers (lines starting with # followed by space or EOL)
+ * - HTML comments (<!-- ... -->)
+ * - Empty markdown list items (- [ ])
+ *
+ * If the file doesn't exist (null/undefined), returns false so the
+ * heartbeat still runs and the agent can decide what to do.
+ */
+export declare function isHeartbeatContentEffectivelyEmpty(content: string | undefined | null): boolean;
+/**
+ * Strip the HEARTBEAT_OK token from a response and determine if the
+ * response should be suppressed (not sent to the channel).
+ *
+ * - Empty/missing response -> suppressed
+ * - No token present -> not suppressed, text returned as-is
+ * - Token stripped, remaining text <= ackMaxChars -> suppressed
+ * - Token stripped, remaining text > ackMaxChars -> not suppressed, stripped text returned
+ */
+export declare function stripHeartbeatToken(raw: string | undefined, ackMaxChars?: number): {
+    shouldSkip: boolean;
+    text: string;
+};
+//# sourceMappingURL=heartbeat-token.d.ts.map

package/dist/cron/heartbeat-token.js

@@ -0,0 +1 @@
+export const HEARTBEAT_TOKEN="HEARTBEAT_OK";export function isHeartbeatContentEffectivelyEmpty(t){if(null==t)return!1;if("string"!=typeof t)return!1;const e=t.replace(/<!--[\s\S]*?-->/g,"").split("\n");for(const t of e){const e=t.trim();if(e&&(!/^#+(\s|$)/.test(e)&&!/^[-*+]\s*(\[[\sXx]?\]\s*)?$/.test(e)))return!1}return!0}function t(t){let e=t.trim();if(!e)return{text:"",didStrip:!1};const r="HEARTBEAT_OK";if(!e.includes(r))return{text:e,didStrip:!1};let i=!1,n=!0;for(;n;){n=!1;const t=e.trim();t.startsWith(r)?(e=t.slice(12).trimStart(),i=!0,n=!0):t.endsWith(r)&&(e=t.slice(0,Math.max(0,t.length-12)).trimEnd(),i=!0,n=!0)}return{text:e.replace(/\s+/g," ").trim(),didStrip:i}}export function stripHeartbeatToken(e,r=300){if(!e)return{shouldSkip:!0,text:""};const i=e.trim();if(!i)return{shouldSkip:!0,text:""};const n=i.replace(/<[^>]*>/g," ").replace(/&nbsp;/gi," ").replace(/^[*`~_]+/,"").replace(/[*`~_]+$/,"");if(!(i.includes("HEARTBEAT_OK")||n.includes("HEARTBEAT_OK")))return{shouldSkip:!1,text:i};const s=t(i),o=t(n),u=s.didStrip&&s.text?s:o;if(!u.didStrip)return{shouldSkip:!1,text:i};if(!u.text)return{shouldSkip:!0,text:""};const l=u.text.trim();return l.length<=r?{shouldSkip:!0,text:""}:{shouldSkip:!1,text:l}}

package/dist/cron/schedule.d.ts

@@ -0,0 +1,3 @@
+import type { CronSchedule } from "./types.js";
+export declare function computeNextRunAtMs(schedule: CronSchedule, nowMs: number, defaultTimezone?: string): number | undefined;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/cron/schedule.js

@@ -0,0 +1 @@
+import{Cron as t}from"croner";export function computeNextRunAtMs(e,r,n){if("at"===e.kind){const t=new Date(e.at).getTime();if(!Number.isFinite(t))return;return t>r?t:void 0}if("every"===e.kind){const t=Math.max(1,Math.floor(e.everyMs)),n=Math.max(0,Math.floor(e.anchorMs??r));if(r<n)return n;const o=r-n;return n+Math.max(1,Math.floor((o+t-1)/t))*t}const o=e.expr.trim();if(!o)return;const i=new t(o,{timezone:e.tz?.trim()||n||void 0}).nextRun(new Date(r));return i?i.getTime():void 0}

package/dist/cron/store.d.ts

@@ -0,0 +1,4 @@
+import type { CronStoreFile } from "./types.js";
+export declare function loadCronStore(storePath: string): Promise<CronStoreFile>;
+export declare function saveCronStore(storePath: string, store: CronStoreFile): Promise<void>;
+//# sourceMappingURL=store.d.ts.map

package/dist/cron/store.js

@@ -0,0 +1 @@
+import r from"node:fs";import o from"node:path";export async function loadCronStore(o){try{const e=await r.promises.readFile(o,"utf-8"),t=JSON.parse(e);return{version:1,jobs:(Array.isArray(t?.jobs)?t.jobs:[]).filter(Boolean)}}catch{return{version:1,jobs:[]}}}export async function saveCronStore(e,t){await r.promises.mkdir(o.dirname(e),{recursive:!0});const i=`${e}.${process.pid}.${Math.random().toString(16).slice(2)}.tmp`,s=JSON.stringify(t,null,2);await r.promises.writeFile(i,s,"utf-8"),await r.promises.rename(i,e);try{await r.promises.copyFile(e,`${e}.bak`)}catch{}}

package/dist/cron/types.d.ts

@@ -0,0 +1,47 @@
+export type CronSchedule = {
+    kind: "at";
+    at: string;
+} | {
+    kind: "every";
+    everyMs: number;
+    anchorMs?: number;
+} | {
+    kind: "cron";
+    expr: string;
+    tz?: string;
+};
+export type CronJobState = {
+    nextRunAtMs?: number;
+    runningAtMs?: number;
+    lastRunAtMs?: number;
+    lastStatus?: "ok" | "error" | "skipped";
+    lastError?: string;
+    lastDurationMs?: number;
+};
+export type CronJob = {
+    id: string;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    isolated: boolean;
+    deleteAfterRun?: boolean;
+    suppressToken: boolean;
+    createdAtMs: number;
+    updatedAtMs: number;
+    schedule: CronSchedule;
+    channel: string;
+    chatId: string;
+    message: string;
+    state: CronJobState;
+};
+export type CronStoreFile = {
+    version: 1;
+    jobs: CronJob[];
+};
+export type CronJobCreate = Omit<CronJob, "id" | "createdAtMs" | "updatedAtMs" | "state"> & {
+    state?: Partial<CronJobState>;
+};
+export type CronJobPatch = Partial<Omit<CronJob, "id" | "createdAtMs" | "state">> & {
+    state?: Partial<CronJobState>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/cron/types.js

@@ -0,0 +1 @@
+export{};

package/dist/gateway/bridge.d.ts

@@ -0,0 +1,38 @@
+export interface Attachment {
+    type: "image" | "voice" | "audio" | "document" | "video" | "video_note" | "sticker" | "location" | "contact";
+    mimeType?: string;
+    fileName?: string;
+    fileSize?: number;
+    duration?: number;
+    caption?: string;
+    metadata?: Record<string, unknown>;
+    getBuffer(): Promise<Buffer>;
+}
+export interface IncomingMessage {
+    chatId: string;
+    userId: string;
+    channelName: string;
+    text?: string;
+    attachments: Attachment[];
+    username?: string;
+    rawContext?: unknown;
+}
+export type MessageHandler = (msg: IncomingMessage) => Promise<string>;
+export type InlineButton = {
+    text: string;
+    callbackData?: string;
+    url?: string;
+};
+export interface ChannelAdapter {
+    readonly name: string;
+    start(onMessage: MessageHandler): Promise<void>;
+    sendText(chatId: string, text: string): Promise<void>;
+    sendAudio?(chatId: string, filePath: string, asVoice?: boolean): Promise<void>;
+    sendButtons?(chatId: string, text: string, buttons: InlineButton[]): Promise<void>;
+    setTyping?(chatId: string): Promise<void>;
+    clearTyping?(chatId: string): Promise<void>;
+    /** Cooperative typing release: decrements refcount instead of force-clearing. */
+    releaseTyping?(chatId: string): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/gateway/bridge.js

@@ -0,0 +1 @@
+export{};

package/dist/gateway/channel-manager.d.ts

@@ -0,0 +1,45 @@
+import type { AppConfig } from "../config.js";
+import type { TokenDB } from "../auth/token-db.js";
+import type { ChannelAdapter, InlineButton, MessageHandler } from "./bridge.js";
+export declare class ChannelManager {
+    private config;
+    private tokenDb;
+    private onMessage;
+    private adapters;
+    constructor(config: AppConfig, tokenDb: TokenDB, onMessage: MessageHandler);
+    registerAdapter(adapter: ChannelAdapter): void;
+    startAll(): Promise<void>;
+    sendToChannel(channelName: string, chatId: string, text: string): Promise<void>;
+    sendAudio(channelName: string, chatId: string, filePath: string, asVoice?: boolean): Promise<void>;
+    sendButtons(channelName: string, chatId: string, text: string, buttons: InlineButton[]): Promise<void>;
+    setTyping(channelName: string, chatId: string): Promise<void>;
+    clearTyping(channelName: string, chatId: string): Promise<void>;
+    /**
+     * Cooperative typing release: decrements the inflight refcount instead of
+     * force-clearing.  The typing interval will self-destruct when no more
+     * handlers are in-flight. Use this in the normal message-completion path;
+     * reserve clearTyping() as a safety-net for hard resets.
+     */
+    releaseTyping(channelName: string, chatId: string): Promise<void>;
+    /**
+     * Send a full response that may contain MEDIA: lines.
+     * Parses out media entries, sends audio via sendAudio, and sends remaining text via sendText.
+     */
+    sendResponse(channelName: string, chatId: string, fullResponse: string): Promise<void>;
+    getAdapter(name: string): ChannelAdapter | undefined;
+    /**
+     * Get a channel by name (alias for getAdapter for compatibility)
+     */
+    getChannel(name: string): ChannelAdapter | undefined;
+    /**
+     * Send a system message directly to a channel
+     * This bypasses the normal message flow and sends directly
+     */
+    sendSystemMessage(channelName: string, chatId: string, message: string): Promise<void>;
+    listAdapters(): Array<{
+        name: string;
+        active: boolean;
+    }>;
+    stopAll(): Promise<void>;
+}
+//# sourceMappingURL=channel-manager.d.ts.map

package/dist/gateway/channel-manager.js

@@ -0,0 +1 @@
+import{parseMediaLines as t}from"../utils/media-response.js";import{createLogger as e}from"../utils/logger.js";const s=e("ChannelManager");export class ChannelManager{config;tokenDb;onMessage;adapters=new Map;constructor(t,e,s){this.config=t,this.tokenDb=e,this.onMessage=s}registerAdapter(t){this.adapters.set(t.name,t)}async startAll(){const t=[];for(const[e,n]of this.adapters)s.info(`Starting channel: ${e}`),t.push(n.start(this.onMessage).then(()=>{s.info(`Channel started: ${e}`)}).catch(t=>{s.error(`Failed to start channel ${e}: ${t}`)}));await Promise.allSettled(t)}async sendToChannel(t,e,n){const a=this.adapters.get(t);a?await a.sendText(e,n):s.error(`Channel not found: ${t}`)}async sendAudio(t,e,n,a){const r=this.adapters.get(t);r?r.sendAudio?await r.sendAudio(e,n,a):s.warn(`Channel ${t} does not support audio, skipping`):s.error(`Channel not found: ${t}`)}async sendButtons(t,e,n,a){const r=this.adapters.get(t);if(r)if(r.sendButtons)await r.sendButtons(e,n,a);else{const t=a.map((t,e)=>`${e+1}. ${t.text}`).join("\n");await r.sendText(e,`${n}\n\n${t}\n\nReply with your choice or type your answer.`)}else s.error(`Channel not found: ${t}`)}async setTyping(t,e){const s=this.adapters.get(t);if(s&&s.setTyping)try{await s.setTyping(e)}catch{}}async clearTyping(t,e){const s=this.adapters.get(t);if(s&&s.clearTyping)try{await s.clearTyping(e)}catch{}}async releaseTyping(t,e){const s=this.adapters.get(t);if(s)if(s.releaseTyping)try{await s.releaseTyping(e)}catch{}else if(s.clearTyping)try{await s.clearTyping(e)}catch{}}async sendResponse(e,n,a){const{textParts:r,mediaEntries:o}=t(a);for(const t of o)try{await this.sendAudio(e,n,t.path,t.asVoice)}catch(t){s.error(`Failed to send audio to ${e}:${n}: ${t}`)}const i=r.join("\n").trim();i&&await this.sendToChannel(e,n,i)}getAdapter(t){return this.adapters.get(t)}getChannel(t){return this.adapters.get(t)}async sendSystemMessage(t,e,n){const a=this.adapters.get(t);if(a)try{await a.sendText(e,n),s.debug(`System message sent to ${t}:${e}`)}catch(n){s.error(`Failed to send system message to ${t}:${e}: ${n}`)}else s.warn(`Cannot send system message: channel ${t} not found`)}listAdapters(){return[...this.adapters.entries()].map(([t])=>({name:t,active:!0}))}async stopAll(){const t=[];for(const[e,n]of this.adapters)s.info(`Stopping channel: ${e}`),t.push(n.stop().catch(t=>{s.error(`Error stopping channel ${e}: ${t}`)}));await Promise.allSettled(t)}}

package/dist/gateway/channels/qr-image.d.ts

@@ -0,0 +1,5 @@
+export declare function renderQrPngBase64(input: string, opts?: {
+    scale?: number;
+    marginModules?: number;
+}): Promise<string>;
+//# sourceMappingURL=qr-image.d.ts.map

package/dist/gateway/channels/qr-image.js

@@ -0,0 +1 @@
+import{deflateSync as r}from"node:zlib";import t from"qrcode-terminal/vendor/QRCode/index.js";import o from"qrcode-terminal/vendor/QRCode/QRErrorCorrectLevel.js";const e=t,n=o;function f(r,t,o,e,n,f,c,l=255){const u=4*(o*e+t);r[u]=n,r[u+1]=f,r[u+2]=c,r[u+3]=l}const c=function(){const r=new Uint32Array(256);for(let t=0;t<256;t+=1){let o=t;for(let r=0;r<8;r+=1)o=1&o?3988292384^o>>>1:o>>>1;r[t]=o>>>0}return r}();function l(r,t){const o=Buffer.from(r,"ascii"),e=Buffer.alloc(4);e.writeUInt32BE(t.length,0);const n=function(r){let t=4294967295;for(let o=0;o<r.length;o+=1)t=c[255&(t^r[o])]^t>>>8;return(4294967295^t)>>>0}(Buffer.concat([o,t])),f=Buffer.alloc(4);return f.writeUInt32BE(n,0),Buffer.concat([e,o,t,f])}export async function renderQrPngBase64(t,o={}){const{scale:c=6,marginModules:u=4}=o,i=function(r){const t=new e(-1,n.L);return t.addData(r),t.make(),t}(t),a=i.getModuleCount(),s=(a+2*u)*c,B=Buffer.alloc(s*s*4,255);for(let r=0;r<a;r+=1)for(let t=0;t<a;t+=1){if(!i.isDark(r,t))continue;const o=(t+u)*c,e=(r+u)*c;for(let r=0;r<c;r+=1)for(let t=0;t<c;t+=1)f(B,o+t,e+r,s,0,0,0,255)}return function(t,o,e){const n=4*o,f=Buffer.alloc((n+1)*e);for(let r=0;r<e;r+=1){const o=r*(n+1);f[o]=0,t.copy(f,o+1,r*n,r*n+n)}const c=r(f),u=Buffer.from([137,80,78,71,13,10,26,10]),i=Buffer.alloc(13);return i.writeUInt32BE(o,0),i.writeUInt32BE(e,4),i[8]=8,i[9]=6,i[10]=0,i[11]=0,i[12]=0,Buffer.concat([u,l("IHDR",i),l("IDAT",c),l("IEND",Buffer.alloc(0))])}(B,s,s).toString("base64")}

package/dist/gateway/channels/telegram.d.ts

@@ -0,0 +1,39 @@
+import type { ChannelAdapter, MessageHandler, InlineButton } from "../bridge.js";
+import type { TokenDB } from "../../auth/token-db.js";
+interface TelegramAccountConfig {
+    botToken: string;
+    dmPolicy: string;
+    allowFrom: Array<string | number>;
+}
+export declare class TelegramChannel implements ChannelAdapter {
+    readonly name = "telegram";
+    private bot;
+    private config;
+    private tokenDb;
+    private typingIntervals;
+    private inflightTyping;
+    private inflightCount;
+    constructor(config: TelegramAccountConfig, tokenDb: TokenDB, inflightTyping?: boolean);
+    start(onMessage: MessageHandler): Promise<void>;
+    sendText(chatId: string, text: string): Promise<void>;
+    setTyping(chatId: string): Promise<void>;
+    /** Re-send typing if an interval is active (another handler is still processing). */
+    private resendTypingIfActive;
+    clearTyping(chatId: string): Promise<void>;
+    releaseTyping(chatId: string): Promise<void>;
+    private startTypingInterval;
+    private stopTypingInterval;
+    sendButtons(chatId: string, text: string, buttons: InlineButton[]): Promise<void>;
+    sendAudio(chatId: string, filePath: string, asVoice?: boolean): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Process an incoming message in the background.
+     * Not awaited by the Grammy handler so the polling loop stays unblocked.
+     */
+    private handleIncoming;
+    private buildIncomingMessage;
+    private downloadFile;
+    private sendChunked;
+}
+export {};
+//# sourceMappingURL=telegram.d.ts.map

package/dist/gateway/channels/telegram.js

@@ -0,0 +1 @@
+import{Bot as t,InputFile as e,InlineKeyboard as i}from"grammy";import{validateChannelUser as a}from"../../auth/auth-middleware.js";import{parseMediaLines as n}from"../../utils/media-response.js";import{markdownToTelegramHtmlChunks as o}from"../../utils/telegram-format.js";import{createLogger as s}from"../../utils/logger.js";const r=s("Telegram");export class TelegramChannel{name="telegram";bot;config;tokenDb;typingIntervals=new Map;inflightTyping;inflightCount=new Map;constructor(e,i,a=!0){this.config=e,this.tokenDb=i,this.inflightTyping=a,this.bot=new t(e.botToken)}async start(t){this.bot.on("message",e=>{this.handleIncoming(e,t)}),this.bot.on("callback_query:data",e=>{const i=e.callbackQuery.data,a=String(e.from?.id??"unknown"),n=String(e.chat?.id??e.callbackQuery.message?.chat?.id??"unknown"),o=e.from?.username;e.answerCallbackQuery().catch(()=>{}),this.startTypingInterval(n);t({chatId:n,userId:a,channelName:"telegram",text:i,attachments:[],username:o,rawContext:e}).then(async t=>{t&&t.trim()&&await this.sendText(n,t)}).catch(t=>{r.error(`Error handling callback from ${a}: ${t}`)})}),r.info("Starting Telegram bot..."),this.bot.start({onStart:t=>{r.info(`Telegram bot started: @${t.username}`)}})}async sendText(t,e){const i=o(e,4096);for(const a of i)try{await this.bot.api.sendMessage(t,a,{parse_mode:"HTML"})}catch{const i=c(e,4096);for(const e of i)await this.bot.api.sendMessage(t,e);break}await this.resendTypingIfActive(t)}async setTyping(t){this.typingIntervals.has(t)?await this.bot.api.sendChatAction(t,"typing").catch(()=>{}):this.startTypingInterval(t)}async resendTypingIfActive(t){this.typingIntervals.has(t)&&await this.bot.api.sendChatAction(t,"typing").catch(()=>{})}async clearTyping(t){this.inflightCount.delete(t);const e=this.typingIntervals.get(t);e&&(clearInterval(e),this.typingIntervals.delete(t))}async releaseTyping(t){this.stopTypingInterval(t)}startTypingInterval(t){if(this.inflightTyping){const e=(this.inflightCount.get(t)??0)+1;if(this.inflightCount.set(t,e),e>1)return}const e=this.typingIntervals.get(t);e&&(clearInterval(e),this.typingIntervals.delete(t)),this.bot.api.sendChatAction(t,"typing").catch(()=>{});const i=setInterval(()=>{const e=this.inflightCount.get(t)??0;!this.inflightTyping||e>0?this.bot.api.sendChatAction(t,"typing").catch(()=>{}):(clearInterval(i),this.typingIntervals.delete(t))},4e3);this.typingIntervals.set(t,i)}stopTypingInterval(t){if(this.inflightTyping){const e=(this.inflightCount.get(t)??1)-1;return void(e>0?this.inflightCount.set(t,e):this.inflightCount.delete(t))}const e=this.typingIntervals.get(t);e&&(clearInterval(e),this.typingIntervals.delete(t))}async sendButtons(t,e,a){const n=new i;for(const t of a)t.url?n.url(t.text,t.url):n.text(t.text,t.callbackData??t.text),n.row();const s=o(e,4096);for(let i=0;i<s.length-1;i++)try{await this.bot.api.sendMessage(t,s[i],{parse_mode:"HTML"})}catch{await this.bot.api.sendMessage(t,e.slice(0,4096))}const r=s[s.length-1]??e;try{await this.bot.api.sendMessage(t,r,{parse_mode:"HTML",reply_markup:n})}catch{await this.bot.api.sendMessage(t,e.slice(0,4096),{reply_markup:n})}await this.resendTypingIfActive(t)}async sendAudio(t,i,a){const n=new e(i);a?await this.bot.api.sendVoice(t,n):await this.bot.api.sendAudio(t,n),await this.resendTypingIfActive(t)}async stop(){try{await this.bot.stop(),r.info("Telegram bot stopped"),await new Promise(t=>setTimeout(t,100))}catch(t){r.warn(`Error stopping Telegram bot: ${t}`)}}async handleIncoming(t,i){const o=String(t.from?.id??"unknown"),s=String(t.chat?.id??"unknown"),c=t.from?.username,l=a(this.tokenDb,o,"telegram",this.config.dmPolicy,this.config.allowFrom);if(!l.authorized)return r.warn(`Unauthorized message from ${o} (@${c})`),void await t.reply(l.reason??"Not authorized.");this.startTypingInterval(s);try{const a=await this.buildIncomingMessage(t,s,o,c),l=await i(a),{textParts:h,mediaEntries:d}=n(l);for(const i of d)try{const a=new e(i.path);i.asVoice?await t.replyWithVoice(a):await t.replyWithAudio(a)}catch(t){r.error(`Failed to send audio: ${t}`)}const p=h.join("\n").trim();p&&await this.sendChunked(t,p),await this.resendTypingIfActive(s)}catch(e){r.error(`Error handling message from ${o}: ${e}`),await t.reply("An error occurred while processing your message.").catch(()=>{})}}async buildIncomingMessage(t,e,i,a){const n=t.message,o=[];let s=n.text??n.caption??void 0;if(n.photo&&n.photo.length>0){const e=n.photo[n.photo.length-1];o.push({type:"image",mimeType:"image/jpeg",fileSize:e.file_size,caption:n.caption,getBuffer:()=>this.downloadFile(t,e.file_id)})}return n.voice&&o.push({type:"voice",mimeType:n.voice.mime_type??"audio/ogg",duration:n.voice.duration,fileSize:n.voice.file_size,getBuffer:()=>this.downloadFile(t,n.voice.file_id)}),n.audio&&o.push({type:"audio",mimeType:n.audio.mime_type??"audio/mpeg",fileName:n.audio.file_name,duration:n.audio.duration,fileSize:n.audio.file_size,caption:n.caption,getBuffer:()=>this.downloadFile(t,n.audio.file_id)}),n.document&&o.push({type:"document",mimeType:n.document.mime_type,fileName:n.document.file_name,fileSize:n.document.file_size,caption:n.caption,getBuffer:()=>this.downloadFile(t,n.document.file_id)}),n.video&&o.push({type:"video",mimeType:n.video.mime_type??"video/mp4",fileName:n.video.file_name,duration:n.video.duration,fileSize:n.video.file_size,caption:n.caption,getBuffer:()=>this.downloadFile(t,n.video.file_id)}),n.video_note&&o.push({type:"video_note",mimeType:"video/mp4",duration:n.video_note.duration,fileSize:n.video_note.file_size,getBuffer:()=>this.downloadFile(t,n.video_note.file_id)}),n.sticker&&o.push({type:"sticker",mimeType:n.sticker.is_animated?"application/x-tgsticker":n.sticker.is_video?"video/webm":"image/webp",metadata:{emoji:n.sticker.emoji,setName:n.sticker.set_name},getBuffer:()=>this.downloadFile(t,n.sticker.file_id)}),n.location&&o.push({type:"location",metadata:{latitude:n.location.latitude,longitude:n.location.longitude},getBuffer:async()=>Buffer.alloc(0)}),n.contact&&o.push({type:"contact",metadata:{phoneNumber:n.contact.phone_number,firstName:n.contact.first_name,lastName:n.contact.last_name,userId:n.contact.user_id},getBuffer:async()=>Buffer.alloc(0)}),{chatId:e,userId:i,channelName:"telegram",text:s,attachments:o,username:a,rawContext:t}}async downloadFile(t,e){const i=await t.api.getFile(e),a=`https://api.telegram.org/file/bot${this.config.botToken}/${i.file_path}`,n=await fetch(a);if(!n.ok)throw new Error(`Failed to download file: ${n.statusText}`);return Buffer.from(await n.arrayBuffer())}async sendChunked(t,e){const i=o(e,4096);for(const a of i)try{await t.reply(a,{parse_mode:"HTML"})}catch{const i=c(e,4096);for(const e of i)await t.reply(e);break}}}function c(t,e){if(t.length<=e)return[t];const i=[];let a=t;for(;a.length>0;){if(a.length<=e){i.push(a);break}let t=a.lastIndexOf("\n",e);t<=0&&(t=e),i.push(a.slice(0,t)),a=a.slice(t).trimStart()}return i}