@babyclaw/gateway 0.0.0

package/dist/index.d.ts

@@ -0,0 +1,228 @@
+import { z } from 'zod';
+import { LanguageModel } from 'ai';
+import pino from 'pino';
+export { Logger } from 'pino';
+
+declare const babyclawConfigSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    telegram: z.ZodOptional<z.ZodObject<{
+        botToken: z.ZodString;
+    }, z.core.$strict>>;
+    channels: z.ZodDefault<z.ZodObject<{
+        telegram: z.ZodOptional<z.ZodObject<{
+            botToken: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    ai: z.ZodObject<{
+        providers: z.ZodRecord<z.ZodString, z.ZodObject<{
+            apiKey: z.ZodString;
+            baseUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        models: z.ZodObject<{
+            chat: z.ZodString;
+            vision: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        aliases: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>;
+    scheduler: z.ZodDefault<z.ZodObject<{
+        timezone: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>>;
+    workspace: z.ZodDefault<z.ZodObject<{
+        root: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>>;
+    session: z.ZodDefault<z.ZodObject<{
+        maxMessagesPerSession: z.ZodDefault<z.ZodNumber>;
+        historyLimit: z.ZodDefault<z.ZodNumber>;
+        replyChainMode: z.ZodDefault<z.ZodEnum<{
+            default: "default";
+            "reply-chain": "reply-chain";
+        }>>;
+        titleGeneration: z.ZodDefault<z.ZodObject<{
+            model: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    tools: z.ZodDefault<z.ZodObject<{
+        enableGenericTools: z.ZodDefault<z.ZodBoolean>;
+        shell: z.ZodDefault<z.ZodObject<{
+            mode: z.ZodDefault<z.ZodEnum<{
+                allowlist: "allowlist";
+                "full-access": "full-access";
+            }>>;
+            allowedCommands: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        webSearch: z.ZodDefault<z.ZodObject<{
+            braveApiKey: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    skills: z.ZodDefault<z.ZodObject<{
+        entries: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            apiKey: z.ZodOptional<z.ZodString>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    logging: z.ZodDefault<z.ZodObject<{
+        level: z.ZodDefault<z.ZodEnum<{
+            debug: "debug";
+            info: "info";
+            warn: "warn";
+            error: "error";
+        }>>;
+        format: z.ZodDefault<z.ZodEnum<{
+            json: "json";
+            pretty: "pretty";
+        }>>;
+        output: z.ZodDefault<z.ZodString>;
+        redact: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        includeTimestamps: z.ZodDefault<z.ZodBoolean>;
+        includeHostname: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    heartbeat: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        intervalMinutes: z.ZodDefault<z.ZodNumber>;
+        activeHours: z.ZodDefault<z.ZodObject<{
+            start: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            end: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+        prompt: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+
+type BabyclawConfig = z.infer<typeof babyclawConfigSchema>;
+
+type GatewayStatus = {
+    state: "stopped" | "starting" | "running" | "stopping";
+    uptimeMs: number | null;
+    configPath: string | null;
+    pid: number;
+    version: string;
+};
+declare class GatewayRuntime {
+    private state;
+    private startedAt;
+    private config;
+    private log;
+    private db;
+    private schedulerRuntime;
+    private heartbeatRuntime;
+    private adminServer;
+    private channelRouter;
+    private memoryExtractionQueue;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): GatewayStatus;
+    getConfig(): BabyclawConfig | null;
+    registerSignalHandlers(): void;
+}
+
+type AdminClientInput = {
+    socketPath: string;
+};
+declare class AdminClient {
+    private readonly socketPath;
+    constructor({ socketPath }: AdminClientInput);
+    status(): Promise<{
+        state: string;
+        uptimeMs: number | null;
+        version: string;
+        pid: number;
+    }>;
+    health(): Promise<{
+        ok: boolean;
+    }>;
+    shutdown(): Promise<{
+        ok: boolean;
+    }>;
+    private get;
+}
+
+declare function getAdminSocketPath(): string;
+
+declare function loadConfig(): Promise<BabyclawConfig>;
+declare function loadConfigRaw(): Promise<BabyclawConfig | null>;
+declare function writeConfig({ config }: {
+    config: BabyclawConfig;
+}): Promise<void>;
+
+declare const CONFIG_PATH_ENV_VAR = "BABYCLAW_CONFIG_PATH";
+declare function getDefaultConfigPath(): string;
+declare function getConfigPath(): string;
+
+declare function getDefaultConfigTemplate(): string;
+
+type InstallSkillResult = {
+    slug: string;
+    version: string;
+    displayName: string;
+    files: string[];
+    skillPath: string;
+};
+declare class SkillAlreadyInstalledError extends Error {
+    readonly slug: string;
+    readonly skillPath: string;
+    constructor({ slug, skillPath }: {
+        slug: string;
+        skillPath: string;
+    });
+}
+declare function installSkillFromClawHub({ slug, version, workspacePath, force, }: {
+    slug: string;
+    version?: string;
+    workspacePath: string;
+    force?: boolean;
+}): Promise<InstallSkillResult>;
+
+declare class ClawHubError extends Error {
+    readonly statusCode: number;
+    readonly slug: string;
+    constructor({ statusCode, slug, message, }: {
+        statusCode: number;
+        slug: string;
+        message: string;
+    });
+}
+
+type SkillSetupResult = {
+    skipped: boolean;
+    agentResponse: string;
+};
+type RunSkillSetupInput = {
+    model: LanguageModel;
+    skillPath: string;
+    workspacePath: string;
+};
+declare function runSkillSetup({ model, skillPath, workspacePath, }: RunSkillSetupInput): Promise<SkillSetupResult>;
+
+type ProviderMeta = {
+    id: string;
+    displayName: string;
+    exampleModels: string[];
+};
+declare const SUPPORTED_PROVIDERS: ProviderMeta[];
+declare function resolveLanguageModel({ config }: {
+    config: BabyclawConfig;
+}): LanguageModel;
+
+declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error"];
+type LogLevel = (typeof LOG_LEVELS)[number];
+declare const LOG_FORMATS: readonly ["json", "pretty"];
+type LogFormat = (typeof LOG_FORMATS)[number];
+type LoggingConfig = {
+    level: LogLevel;
+    format: LogFormat;
+    output: string;
+    redact: string[];
+    includeTimestamps: boolean;
+    includeHostname: boolean;
+};
+
+declare function createLogger({ config }: {
+    config?: Partial<LoggingConfig>;
+}): pino.Logger;
+declare function getLogger(): pino.Logger;
+declare function createChildLogger({ context }: {
+    context: Record<string, unknown>;
+}): pino.Logger;
+
+export { AdminClient, type BabyclawConfig, CONFIG_PATH_ENV_VAR, ClawHubError, GatewayRuntime, type GatewayStatus, type InstallSkillResult, type LogFormat, type LogLevel, type LoggingConfig, SUPPORTED_PROVIDERS, SkillAlreadyInstalledError, type SkillSetupResult, babyclawConfigSchema, createChildLogger, createLogger, getAdminSocketPath, getConfigPath, getDefaultConfigPath, getDefaultConfigTemplate, getLogger, installSkillFromClawHub, loadConfig, loadConfigRaw, resolveLanguageModel, runSkillSetup, writeConfig };