@swarmclawai/swarmclaw 1.9.29 → 1.9.31

package/README.md

@@ -151,6 +151,21 @@ clawhub install swarmclaw
 
 [Browse on ClawHub](https://clawhub.ai/skills/swarmclaw)
 
+## v1.9.31 Highlights
+
+Documentation cleanup release for public release notes and OpenClaw guidance. No runtime behavior changed.
+
+- **Public docs cleanup.** Removed an unwanted third-party example from the README and site release notes.
+- **OpenClaw guidance preserved.** The README keeps the SwarmClaw-native OpenClaw gateway, skill, and agent-file guidance without naming unrelated workflows.
+
+## v1.9.30 Highlights
+
+PR integration release for dream-model routing, email bridge TLS opt-outs, and installed CLI runtime resolution.
+
+- **Dream model routing.** Memory dream cycles and daily digests can use optional `dreamProvider` settings so background consolidation can run on a smaller local model.
+- **Email bridge TLS opt-outs.** `tlsRejectUnauthorized=false` now disables hostname checks too, matching the explicit self-signed-server opt-out.
+- **Installed CLI stability.** Legacy API-backed CLI commands import the package-local `tsx` runtime instead of resolving `tsx` from the caller's project.
+
 ## v1.9.29 Highlights
 
 Issue-fix release for Edit Agent tooltips, installed package builds, and structured dream output on local Ollama models.
@@ -219,6 +234,7 @@ SwarmClaw is built for OpenClaw operators who need more than one agent or one ga
 - Deploy official-image OpenClaw runtimes locally, via VPS bundles, or over SSH.
 - Edit OpenClaw agent files such as `SOUL.md`, `IDENTITY.md`, `USER.md`, `TOOLS.md`, and `AGENTS.md`.
 - Import OpenClaw `SKILL.md` files and use them in SwarmClaw's runtime skill system.
+- Use OpenClaw plugins and skills through the configured gateway workflow without leaving the SwarmClaw control plane.
 
 ## Use Cases
 
@@ -410,6 +426,21 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.9.31 Highlights
+
+Documentation cleanup release for public release notes and OpenClaw guidance. No runtime behavior changed.
+
+- **Public docs cleanup.** Removed an unwanted third-party example from the README and site release notes.
+- **OpenClaw guidance preserved.** The README keeps the SwarmClaw-native OpenClaw gateway, skill, and agent-file guidance without naming unrelated workflows.
+
+### v1.9.30 Highlights
+
+PR integration release for dream-model routing, email bridge TLS opt-outs, and installed CLI runtime resolution.
+
+- **Dream model routing.** Memory dream cycles and daily digests can use optional `dreamProvider` settings so background consolidation can run on a smaller local model.
+- **Email bridge TLS opt-outs.** `tlsRejectUnauthorized=false` now disables hostname checks too, matching the explicit self-signed-server opt-out.
+- **Installed CLI stability.** Legacy API-backed CLI commands import the package-local `tsx` runtime instead of resolving `tsx` from the caller's project.
+
 ### v1.9.29 Highlights
 
 Issue-fix release for Edit Agent tooltips, installed package builds, and structured dream output on local Ollama models.

package/bin/swarmclaw.js

@@ -47,11 +47,14 @@ function supportsStripTypes() {
 }
 
 function hasTsxRuntime() {
+  return Boolean(resolveTsxRuntimeImportPath())
+}
+
+function resolveTsxRuntimeImportPath() {
   try {
-    require.resolve('tsx/package.json')
-    return true
+    return require.resolve('tsx')
   } catch {
-    return false
+    return null
   }
 }
 
@@ -71,9 +74,10 @@ function buildLegacyTsCliArgs(cliPath, argv, options = {}) {
     return ['--no-warnings', '--experimental-strip-types', cliPath, ...argv]
   }
 
-  const tsxAvailable = options.hasTsxRuntime ?? hasTsxRuntime()
+  const tsxImportPath = options.tsxImportPath ?? resolveTsxRuntimeImportPath()
+  const tsxAvailable = options.hasTsxRuntime ?? Boolean(tsxImportPath)
   if (tsxAvailable) {
-    return ['--no-warnings', '--import', 'tsx', cliPath, ...argv]
+    return ['--no-warnings', '--import', tsxImportPath || 'tsx', cliPath, ...argv]
   }
 
   return null
@@ -374,6 +378,7 @@ module.exports = {
   normalizeLegacyTsCliArgv,
   pathIsInsideNodeModules,
   resolveLegacyTsCliPath,
+  resolveTsxRuntimeImportPath,
   TS_CLI_ACTIONS,
   normalizeLegacyCliEnv,
   printPackageVersion,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.9.29",
+  "version": "1.9.31",
   "description": "Build and run autonomous AI agents with OpenClaw, Hermes, multiple model providers, orchestration, delegation, memory, skills, schedules, and chat connectors.",
   "main": "electron-dist/main.js",
   "license": "MIT",

package/src/cli/binary.test.js

@@ -7,7 +7,7 @@ const fs = require('node:fs')
 const os = require('node:os')
 const path = require('node:path')
 const { spawnSync } = require('node:child_process')
-const { buildLegacyTsCliArgs, resolveLegacyTsCliPath } = require('../../bin/swarmclaw.js')
+const { buildLegacyTsCliArgs, resolveLegacyTsCliPath, resolveTsxRuntimeImportPath } = require('../../bin/swarmclaw.js')
 
 const CLI_BIN = path.join(__dirname, '..', '..', 'bin', 'swarmclaw.js')
 const PACKAGE_JSON = require('../../package.json')
@@ -207,21 +207,30 @@ test('package ships dagre type declarations required by installed builds', () =>
 
 test('legacy TS launcher falls back to tsx import when strip-types is unavailable', () => {
   const cliPath = path.join(APP_ROOT, 'src', 'cli', 'index.ts')
+  const tsxImportPath = resolveTsxRuntimeImportPath()
   const args = buildLegacyTsCliArgs(cliPath, ['runs', 'list'], {
     supportsStripTypes: false,
     hasTsxRuntime: true,
   })
 
-  assert.deepEqual(args, ['--no-warnings', '--import', 'tsx', cliPath, 'runs', 'list'])
+  assert.deepEqual(args, ['--no-warnings', '--import', tsxImportPath, cliPath, 'runs', 'list'])
 })
 
 test('legacy TS launcher uses tsx instead of strip-types inside node_modules', () => {
   const cliPath = path.join(os.tmpdir(), 'node_modules', '@swarmclawai', 'swarmclaw', 'src', 'cli', 'index.ts')
+  const tsxImportPath = resolveTsxRuntimeImportPath()
   const args = buildLegacyTsCliArgs(cliPath, ['agents', 'list'], {
     supportsStripTypes: true,
     hasTsxRuntime: true,
   })
 
-  assert.deepEqual(args, ['--no-warnings', '--import', 'tsx', cliPath, 'agents', 'list'])
+  assert.deepEqual(args, ['--no-warnings', '--import', tsxImportPath, cliPath, 'agents', 'list'])
   assert.equal(resolveLegacyTsCliPath(), path.join(APP_ROOT, 'src', 'cli', 'index.ts'))
 })
+
+test('legacy TS launcher imports the package-local tsx runtime by absolute path', () => {
+  const tsxImportPath = resolveTsxRuntimeImportPath()
+
+  assert.equal(path.isAbsolute(tsxImportPath), true)
+  assert.match(tsxImportPath, /tsx/)
+})

package/src/lib/server/connectors/email.test.ts

@@ -81,7 +81,10 @@ describe('email TLS configuration', () => {
     assert.equal(parseTlsRejectUnauthorized(false), false)
     assert.equal(parseTlsRejectUnauthorized('false'), false)
     assert.equal(parseTlsRejectUnauthorized('0'), false)
-    assert.deepEqual(buildEmailTlsOptions({ tlsRejectUnauthorized: false }), { rejectUnauthorized: false })
+    const tls = buildEmailTlsOptions({ tlsRejectUnauthorized: false })
+    assert.equal(tls.rejectUnauthorized, false)
+    assert.equal(typeof tls.checkServerIdentity, 'function')
+    assert.equal(tls.checkServerIdentity?.('localhost', {} as never), undefined)
   })
 
   it('handles IMAP socket errors without leaving the emitter unhandled', () => {

package/src/lib/server/connectors/email.ts

@@ -1,5 +1,6 @@
 import fs from 'fs'
 import path from 'path'
+import type { ConnectionOptions } from 'node:tls'
 import { ImapFlow } from 'imapflow'
 import { createTransport, type Transporter } from 'nodemailer'
 import { simpleParser } from 'mailparser'
@@ -34,6 +35,10 @@ interface ImapErrorEmitter {
   on(event: 'error', listener: (err: unknown) => void): unknown
 }
 
+type EmailTlsOptions = Pick<ConnectionOptions, 'rejectUnauthorized' | 'checkServerIdentity'> & {
+  rejectUnauthorized: boolean
+}
+
 export function buildAttachments(options?: OutboundSendOptions): MailAttachment[] {
   const source = options?.mediaPath
   if (!source) return []
@@ -59,8 +64,11 @@ export function parseTlsRejectUnauthorized(value: unknown): boolean {
   return true
 }
 
-export function buildEmailTlsOptions(config: Pick<EmailConfig, 'tlsRejectUnauthorized'>): { rejectUnauthorized: boolean } {
-  return { rejectUnauthorized: config.tlsRejectUnauthorized !== false }
+export function buildEmailTlsOptions(config: Pick<EmailConfig, 'tlsRejectUnauthorized'>): EmailTlsOptions {
+  const reject = config.tlsRejectUnauthorized !== false
+  return reject
+    ? { rejectUnauthorized: true }
+    : { rejectUnauthorized: false, checkServerIdentity: () => undefined }
 }
 
 export function attachImapErrorHandler(imap: ImapErrorEmitter, onDisconnected: () => void): void {

package/src/lib/server/memory/dream-generation-preference.ts

@@ -0,0 +1,22 @@
+import type { GenerationModelPreference } from '@/lib/server/build-llm'
+import type { AppSettings } from '@/types'
+
+type DreamGenerationSettings = Pick<AppSettings, 'dreamProvider' | 'dreamModel' | 'dreamCredentialId' | 'dreamEndpoint'> | Record<string, unknown> | null | undefined
+
+function optionalSettingString(value: unknown): string | undefined {
+  const normalized = typeof value === 'string' ? value.trim() : ''
+  return normalized || undefined
+}
+
+export function resolveDreamGenerationPreference(settings: DreamGenerationSettings): GenerationModelPreference | undefined {
+  const record = (settings || {}) as Record<string, unknown>
+  const provider = optionalSettingString(record.dreamProvider)
+  if (!provider) return undefined
+
+  return {
+    provider,
+    model: optionalSettingString(record.dreamModel),
+    credentialId: optionalSettingString(record.dreamCredentialId),
+    apiEndpoint: optionalSettingString(record.dreamEndpoint),
+  }
+}

package/src/lib/server/memory/dream-service.test.ts

@@ -1,7 +1,29 @@
 import assert from 'node:assert/strict'
 import { describe, it } from 'node:test'
+import { resolveDreamGenerationPreference } from './dream-generation-preference'
 import { parseTier2DreamResponseText } from './dream-service'
 
+describe('resolveDreamGenerationPreference', () => {
+  it('returns no preference when no dream provider is configured', () => {
+    assert.equal(resolveDreamGenerationPreference({}), undefined)
+    assert.equal(resolveDreamGenerationPreference({ dreamProvider: '   ' }), undefined)
+  })
+
+  it('builds a trimmed dream model preference from app settings', () => {
+    assert.deepEqual(resolveDreamGenerationPreference({
+      dreamProvider: ' ollama ',
+      dreamModel: ' gemma4:e4b ',
+      dreamCredentialId: ' cred-1 ',
+      dreamEndpoint: ' http://localhost:11434 ',
+    }), {
+      provider: 'ollama',
+      model: 'gemma4:e4b',
+      credentialId: 'cred-1',
+      apiEndpoint: 'http://localhost:11434',
+    })
+  })
+})
+
 describe('parseTier2DreamResponseText', () => {
   it('parses a plain structured dream response', () => {
     const parsed = parseTier2DreamResponseText(JSON.stringify({

package/src/lib/server/memory/dream-service.ts

@@ -6,6 +6,7 @@ import { getMemoryDb } from '@/lib/server/memory/memory-db'
 import { saveDreamCycle } from '@/lib/server/memory/dream-cycles'
 import { errorMessage } from '@/lib/shared-utils'
 import { log } from '@/lib/server/logger'
+import { resolveDreamGenerationPreference } from '@/lib/server/memory/dream-generation-preference'
 
 const TAG = 'dream-service'
 
@@ -214,7 +215,9 @@ ${memoryLines.join('\n')}`
 
   try {
     const { buildLLM } = await import('@/lib/server/build-llm')
-    const { llm } = await buildLLM({ agentId, responseFormat: 'json_object' })
+    const { loadSettings } = await import('@/lib/server/settings/settings-repository')
+    const preferred = resolveDreamGenerationPreference(loadSettings())
+    const { llm } = await buildLLM({ agentId, preferred, responseFormat: 'json_object' })
     const { HumanMessage } = await import('@langchain/core/messages')
 
     const response = await llm.invoke([new HumanMessage(prompt)])

package/src/lib/server/memory/memory-consolidation.test.ts

@@ -38,6 +38,7 @@ after(() => {
 })
 
 test('runDailyConsolidation skips orphaned and CLI-only agent namespaces without reporting errors', async () => {
+  storage.saveSettings({})
   const db = memDb.getMemoryDb()
   const now = Date.now()
   const orphanId = 'live-orphan-agent'
@@ -87,3 +88,39 @@ test('runDailyConsolidation skips orphaned and CLI-only agent namespaces without
     false,
   )
 })
+
+test('canCreateDailyDigestForAgent allows CLI-only agents when a dream model is configured', async () => {
+  const now = Date.now()
+  const agentId = 'dream-routed-cli-agent'
+  storage.saveAgents({
+    [agentId]: {
+      id: agentId,
+      name: 'Dream Routed CLI Agent',
+      description: '',
+      systemPrompt: '',
+      provider: 'claude-cli',
+      model: 'claude-sonnet-4-5',
+      credentialId: null,
+      fallbackCredentialIds: [],
+      apiEndpoint: null,
+      createdAt: now,
+      updatedAt: now,
+    } as Agent,
+  })
+
+  storage.saveSettings({})
+  assert.equal(
+    consolidation.canCreateDailyDigestForAgent(agentId, storage.loadAgents({ includeTrashed: true }), storage.loadSettings()),
+    false,
+  )
+
+  storage.saveSettings({
+    dreamProvider: 'ollama',
+    dreamModel: 'llama3.2',
+    dreamEndpoint: 'http://127.0.0.1:11434',
+  })
+  assert.equal(
+    consolidation.canCreateDailyDigestForAgent(agentId, storage.loadAgents({ includeTrashed: true }), storage.loadSettings()),
+    true,
+  )
+})

package/src/lib/server/memory/memory-consolidation.ts

@@ -4,6 +4,9 @@ import { resolveGenerationModelConfig } from '@/lib/server/build-llm'
 import { HumanMessage } from '@langchain/core/messages'
 import { errorMessage } from '@/lib/shared-utils'
 import { onNextIdleWindow } from '@/lib/server/runtime/idle-window'
+import { loadSettings } from '@/lib/server/settings/settings-repository'
+import { resolveDreamGenerationPreference } from '@/lib/server/memory/dream-generation-preference'
+import type { AppSettings } from '@/types'
 
 let consolidationRegistered = false
 let compactionRegistered = false
@@ -35,14 +38,18 @@ export function registerCompactionIdleCallback(): void {
   })
 }
 
-function canCreateDailyDigestForAgent(
+export function canCreateDailyDigestForAgent(
   agentId: string,
   agents: ReturnType<typeof loadAgents>,
+  settings: Partial<AppSettings> | Record<string, unknown> | null | undefined = loadSettings(),
 ): boolean {
   const agent = agents[agentId]
   if (!agent || agent.trashedAt) return false
   try {
-    resolveGenerationModelConfig({ agentId })
+    resolveGenerationModelConfig({
+      agentId,
+      preferred: resolveDreamGenerationPreference(settings),
+    })
     return true
   } catch (err: unknown) {
     const message = errorMessage(err)
@@ -65,6 +72,7 @@ export async function runDailyConsolidation(): Promise<{
   const memDb = getMemoryDb()
   const counts = memDb.countsByAgent()
   const agents = loadAgents({ includeTrashed: true })
+  const settings = loadSettings()
   const today = new Date().toISOString().slice(0, 10) // YYYY-MM-DD
   const digestTitle = `Daily digest: ${today}`
   const cutoff24h = Date.now() - 24 * 3600_000
@@ -76,7 +84,7 @@ export async function runDailyConsolidation(): Promise<{
     const agentId = agentKey
 
     try {
-      if (!canCreateDailyDigestForAgent(agentId, agents)) continue
+      if (!canCreateDailyDigestForAgent(agentId, agents, settings)) continue
 
       // Check if digest already exists for today
       const existing = memDb.search(digestTitle, agentId)
@@ -109,9 +117,12 @@ export async function runDailyConsolidation(): Promise<{
         ...memoryLines,
       ].join('\n')
 
-      // Use the target agent's configured generation provider
+      // Use an optional dream-model override before the target agent's generation provider.
       const { buildLLM } = await import('@/lib/server/build-llm')
-      const { llm } = await buildLLM({ agentId })
+      const { llm } = await buildLLM({
+        agentId,
+        preferred: resolveDreamGenerationPreference(settings),
+      })
 
       const response = await llm.invoke([new HumanMessage(prompt)])
       const digestContent = typeof response.content === 'string'

package/src/types/app-settings.ts

@@ -27,6 +27,11 @@ export interface AppSettings {
   embeddingModel?: string | null
   embeddingCredentialId?: string | null
   embeddingEndpoint?: string | null
+  // Optional model override for memory consolidation and dream cycles.
+  dreamProvider?: string | null
+  dreamModel?: string | null
+  dreamCredentialId?: string | null
+  dreamEndpoint?: string | null
   loopMode?: LoopMode
   agentLoopRecursionLimit?: number
   delegationMaxDepth?: number