clawdbot 2026.1.4 → 2026.1.5-1

package/dist/config/defaults.js

@@ -1,5 +1,16 @@
 import { resolveTalkApiKey } from "./talk.js";
 let defaultWarnState = { warned: false };
+const DEFAULT_MODEL_ALIASES = {
+    // Anthropic (pi-ai catalog uses "latest" ids without date suffix)
+    opus: "anthropic/claude-opus-4-5",
+    sonnet: "anthropic/claude-sonnet-4-5",
+    // OpenAI
+    gpt: "openai/gpt-5.2",
+    "gpt-mini": "openai/gpt-5-mini",
+    // Google Gemini (3.x are preview ids in the catalog)
+    gemini: "google/gemini-3-pro-preview",
+    "gemini-flash": "google/gemini-3-flash-preview",
+};
 function escapeRegExp(text) {
     return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -56,6 +67,51 @@ export function applyTalkApiKey(config) {
         },
     };
 }
+function normalizeAliasKey(value) {
+    return value.trim().toLowerCase();
+}
+export function applyModelAliasDefaults(cfg) {
+    const existingAgent = cfg.agent;
+    if (!existingAgent)
+        return cfg;
+    const existingAliases = existingAgent?.modelAliases ?? {};
+    const byNormalized = new Map();
+    for (const key of Object.keys(existingAliases)) {
+        const norm = normalizeAliasKey(key);
+        if (!norm)
+            continue;
+        if (!byNormalized.has(norm))
+            byNormalized.set(norm, key);
+    }
+    let mutated = false;
+    const nextAliases = { ...existingAliases };
+    for (const [canonicalKey, target] of Object.entries(DEFAULT_MODEL_ALIASES)) {
+        const norm = normalizeAliasKey(canonicalKey);
+        const existingKey = byNormalized.get(norm);
+        if (!existingKey) {
+            nextAliases[canonicalKey] = target;
+            byNormalized.set(norm, canonicalKey);
+            mutated = true;
+            continue;
+        }
+        const existingValue = String(existingAliases[existingKey] ?? "");
+        if (existingKey !== canonicalKey && existingValue === target) {
+            delete nextAliases[existingKey];
+            nextAliases[canonicalKey] = target;
+            byNormalized.set(norm, canonicalKey);
+            mutated = true;
+        }
+    }
+    if (!mutated)
+        return cfg;
+    return {
+        ...cfg,
+        agent: {
+            ...existingAgent,
+            modelAliases: nextAliases,
+        },
+    };
+}
 export function resetSessionDefaultsWarningForTests() {
     defaultWarnState = { warned: false };
 }

package/dist/config/io.js

@@ -2,11 +2,27 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import JSON5 from "json5";
-import { applyIdentityDefaults, applySessionDefaults, applyTalkApiKey, } from "./defaults.js";
+import { loadShellEnvFallback, resolveShellEnvFallbackTimeoutMs, shouldEnableShellEnvFallback, } from "../infra/shell-env.js";
+import { applyIdentityDefaults, applyModelAliasDefaults, applySessionDefaults, applyTalkApiKey, } from "./defaults.js";
 import { findLegacyConfigIssues } from "./legacy.js";
 import { CONFIG_PATH_CLAWDBOT, resolveConfigPath, resolveStateDir, } from "./paths.js";
 import { validateConfigObject } from "./validation.js";
 import { ClawdbotSchema } from "./zod-schema.js";
+const SHELL_ENV_EXPECTED_KEYS = [
+    "OPENAI_API_KEY",
+    "ANTHROPIC_API_KEY",
+    "ANTHROPIC_OAUTH_TOKEN",
+    "GEMINI_API_KEY",
+    "ZAI_API_KEY",
+    "MINIMAX_API_KEY",
+    "ELEVENLABS_API_KEY",
+    "TELEGRAM_BOT_TOKEN",
+    "DISCORD_BOT_TOKEN",
+    "SLACK_BOT_TOKEN",
+    "SLACK_APP_TOKEN",
+    "CLAWDBOT_GATEWAY_TOKEN",
+    "CLAWDBOT_GATEWAY_PASSWORD",
+];
 function resolveConfigPathForDeps(deps) {
     if (deps.configPath)
         return deps.configPath;
@@ -35,8 +51,18 @@ export function createConfigIO(overrides = {}) {
     const configPath = resolveConfigPathForDeps(deps);
     function loadConfig() {
         try {
-            if (!deps.fs.existsSync(configPath))
+            if (!deps.fs.existsSync(configPath)) {
+                if (shouldEnableShellEnvFallback(deps.env)) {
+                    loadShellEnvFallback({
+                        enabled: true,
+                        env: deps.env,
+                        expectedKeys: SHELL_ENV_EXPECTED_KEYS,
+                        logger: deps.logger,
+                        timeoutMs: resolveShellEnvFallbackTimeoutMs(deps.env),
+                    });
+                }
                 return {};
+            }
             const raw = deps.fs.readFileSync(configPath, "utf-8");
             const parsed = deps.json5.parse(raw);
             if (typeof parsed !== "object" || parsed === null)
@@ -49,7 +75,20 @@ export function createConfigIO(overrides = {}) {
                 }
                 return {};
             }
-            return applySessionDefaults(applyIdentityDefaults(validated.data));
+            const cfg = applyModelAliasDefaults(applySessionDefaults(applyIdentityDefaults(validated.data)));
+            const enabled = shouldEnableShellEnvFallback(deps.env) ||
+                cfg.env?.shellEnv?.enabled === true;
+            if (enabled) {
+                loadShellEnvFallback({
+                    enabled: true,
+                    env: deps.env,
+                    expectedKeys: SHELL_ENV_EXPECTED_KEYS,
+                    logger: deps.logger,
+                    timeoutMs: cfg.env?.shellEnv?.timeoutMs ??
+                        resolveShellEnvFallbackTimeoutMs(deps.env),
+                });
+            }
+            return cfg;
         }
         catch (err) {
             deps.logger.error(`Failed to read config at ${configPath}`, err);
@@ -59,7 +98,7 @@ export function createConfigIO(overrides = {}) {
     async function readConfigFileSnapshot() {
         const exists = deps.fs.existsSync(configPath);
         if (!exists) {
-            const config = applyTalkApiKey(applySessionDefaults({}));
+            const config = applyTalkApiKey(applyModelAliasDefaults(applySessionDefaults({})));
             const legacyIssues = [];
             return {
                 path: configPath,
@@ -109,7 +148,7 @@ export function createConfigIO(overrides = {}) {
                 raw,
                 parsed: parsedRes.parsed,
                 valid: true,
-                config: applyTalkApiKey(applySessionDefaults(validated.config)),
+                config: applyTalkApiKey(applyModelAliasDefaults(applySessionDefaults(validated.config))),
                 issues: [],
                 legacyIssues,
             };
@@ -131,7 +170,9 @@ export function createConfigIO(overrides = {}) {
         await deps.fs.promises.mkdir(path.dirname(configPath), {
             recursive: true,
         });
-        const json = JSON.stringify(cfg, null, 2).trimEnd().concat("\n");
+        const json = JSON.stringify(applyModelAliasDefaults(cfg), null, 2)
+            .trimEnd()
+            .concat("\n");
         await deps.fs.promises.writeFile(configPath, json, "utf-8");
     }
     return {

package/dist/config/paths.js

@@ -18,9 +18,9 @@ export const isNixMode = resolveIsNixMode();
  * Default: ~/.clawdbot
  */
 export function resolveStateDir(env = process.env, homedir = os.homedir) {
-    const override = env.CLAWDBOT_STATE_DIR?.trim();
+    const override = env.CLAWDBOT_STATE_DIR?.trim() || env.CLAWDIS_STATE_DIR?.trim();
     if (override)
-        return override;
+        return resolveUserPath(override);
     return path.join(homedir(), ".clawdbot");
 }
 export const STATE_DIR_CLAWDBOT = resolveStateDir();

package/dist/config/port-defaults.js

@@ -0,0 +1,32 @@
+function isValidPort(port) {
+    return Number.isFinite(port) && port > 0 && port <= 65535;
+}
+function clampPort(port, fallback) {
+    return isValidPort(port) ? port : fallback;
+}
+function derivePort(base, offset, fallback) {
+    return clampPort(base + offset, fallback);
+}
+export const DEFAULT_BRIDGE_PORT = 18790;
+export const DEFAULT_BROWSER_CONTROL_PORT = 18791;
+export const DEFAULT_CANVAS_HOST_PORT = 18793;
+export const DEFAULT_BROWSER_CDP_PORT_RANGE_START = 18800;
+export const DEFAULT_BROWSER_CDP_PORT_RANGE_END = 18899;
+export function deriveDefaultBridgePort(gatewayPort) {
+    return derivePort(gatewayPort, 1, DEFAULT_BRIDGE_PORT);
+}
+export function deriveDefaultBrowserControlPort(gatewayPort) {
+    return derivePort(gatewayPort, 2, DEFAULT_BROWSER_CONTROL_PORT);
+}
+export function deriveDefaultCanvasHostPort(gatewayPort) {
+    return derivePort(gatewayPort, 4, DEFAULT_CANVAS_HOST_PORT);
+}
+export function deriveDefaultBrowserCdpPortRange(browserControlPort) {
+    const start = derivePort(browserControlPort, 9, DEFAULT_BROWSER_CDP_PORT_RANGE_START);
+    const end = clampPort(start +
+        (DEFAULT_BROWSER_CDP_PORT_RANGE_END -
+            DEFAULT_BROWSER_CDP_PORT_RANGE_START), DEFAULT_BROWSER_CDP_PORT_RANGE_END);
+    if (end < start)
+        return { start, end: start };
+    return { start, end };
+}

package/dist/config/sessions.js

@@ -4,6 +4,7 @@ import os from "node:os";
 import path from "node:path";
 import JSON5 from "json5";
 import { normalizeE164 } from "../utils.js";
+import { resolveStateDir } from "./paths.js";
 const GROUP_SURFACES = new Set([
     "whatsapp",
     "telegram",
@@ -13,8 +14,8 @@ const GROUP_SURFACES = new Set([
     "webchat",
     "slack",
 ]);
-export function resolveSessionTranscriptsDir() {
-    return path.join(os.homedir(), ".clawdbot", "sessions");
+export function resolveSessionTranscriptsDir(env = process.env, homedir = os.homedir) {
+    return path.join(resolveStateDir(env, homedir), "sessions");
 }
 export function resolveDefaultSessionStorePath() {
     return path.join(resolveSessionTranscriptsDir(), "sessions.json");

package/dist/config/validation.js

@@ -1,4 +1,4 @@
-import { applyIdentityDefaults, applySessionDefaults } from "./defaults.js";
+import { applyIdentityDefaults, applyModelAliasDefaults, applySessionDefaults, } from "./defaults.js";
 import { findLegacyConfigIssues } from "./legacy.js";
 import { ClawdbotSchema } from "./zod-schema.js";
 export function validateConfigObject(raw) {
@@ -24,6 +24,6 @@ export function validateConfigObject(raw) {
     }
     return {
         ok: true,
-        config: applySessionDefaults(applyIdentityDefaults(validated.data)),
+        config: applyModelAliasDefaults(applySessionDefaults(applyIdentityDefaults(validated.data))),
     };
 }

package/dist/config/zod-schema.js

@@ -256,6 +256,16 @@ const HooksGmailSchema = z
 })
     .optional();
 export const ClawdbotSchema = z.object({
+    env: z
+        .object({
+        shellEnv: z
+            .object({
+            enabled: z.boolean().optional(),
+            timeoutMs: z.number().int().nonnegative().optional(),
+        })
+            .optional(),
+    })
+        .optional(),
     identity: z
         .object({
         name: z.string().optional(),
@@ -346,6 +356,12 @@ export const ClawdbotSchema = z.object({
         modelFallbacks: z.array(z.string()).optional(),
         imageModelFallbacks: z.array(z.string()).optional(),
         contextTokens: z.number().int().positive().optional(),
+        tools: z
+            .object({
+            allow: z.array(z.string()).optional(),
+            deny: z.array(z.string()).optional(),
+        })
+            .optional(),
         thinkingDefault: z
             .union([
             z.literal("off"),