@shadowob/cloud 1.1.7 → 1.1.9

package/images/hermes-runner/entrypoint.mjs

@@ -6,6 +6,7 @@
  */
 
 import { spawn, spawnSync } from 'node:child_process'
+import { createHash } from 'node:crypto'
 import {
   chmodSync,
   cpSync,
@@ -24,6 +25,11 @@ const CONFIG_MOUNT = process.env.SHADOW_RUNNER_CONFIG_MOUNT ?? '/etc/openclaw'
 const RUNTIME_FILES_PATH = join(CONFIG_MOUNT, 'runtime-files.json')
 const RUNTIME_EXTENSIONS_PATH = join(CONFIG_MOUNT, 'runtime-extensions.json')
 const RUNNER_HOME = process.env.HOME ?? '/home/shadow'
+const HERMES_HOME = process.env.HERMES_HOME ?? join(RUNNER_HOME, '.hermes')
+const TEMPLATE_ROUTINES_PATH =
+  process.env.SHADOW_TEMPLATE_ROUTINES_PATH ?? '/etc/shadowob/template-routines.json'
+const HERMES_CRON_STORE_PATH =
+  process.env.HERMES_CRON_STORE_PATH ?? join(HERMES_HOME, 'cron', 'jobs.json')
 const HEALTH_PORT = Number.parseInt(
   process.env.SHADOW_RUNNER_HEALTH_PORT ?? process.env.OPENCLAW_GATEWAY_PORT ?? '3100',
   10,
@@ -76,6 +82,267 @@ function modeForPath(path) {
   return 0o644
 }
 
+function isPlainObject(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+function stableValue(value) {
+  if (Array.isArray(value)) return value.map(stableValue)
+  if (!isPlainObject(value)) return value
+  return Object.fromEntries(
+    Object.entries(value)
+      .sort(([left], [right]) => left.localeCompare(right))
+      .map(([key, item]) => [key, stableValue(item)]),
+  )
+}
+
+function stableHash(value) {
+  return createHash('sha256')
+    .update(JSON.stringify(stableValue(value)))
+    .digest('hex')
+}
+
+function readJsonFile(path, fallback) {
+  if (!existsSync(path)) return fallback
+  try {
+    const parsed = JSON.parse(readFileSync(path, 'utf-8'))
+    return parsed && typeof parsed === 'object' ? parsed : fallback
+  } catch (err) {
+    console.warn(`[entrypoint] Failed to parse ${path}: ${err.message}`)
+    return fallback
+  }
+}
+
+function parseRoutineEveryMinutes(interval) {
+  if (typeof interval !== 'string') return null
+  const match = interval.trim().match(/^(\d+)\s*(m|h|d)$/i)
+  if (!match) return null
+  const amount = Number.parseInt(match[1], 10)
+  if (!Number.isFinite(amount) || amount <= 0) return null
+  const unit = match[2].toLowerCase()
+  return amount * (unit === 'm' ? 1 : unit === 'h' ? 60 : 1440)
+}
+
+function isoNow() {
+  return new Date().toISOString()
+}
+
+function addMinutesIso(minutes) {
+  return new Date(Date.now() + minutes * 60_000).toISOString()
+}
+
+function buildHermesRoutineSchedule(routine) {
+  const schedule = isPlainObject(routine.schedule) ? routine.schedule : {}
+  if (typeof schedule.cron === 'string' && schedule.cron.trim()) {
+    const expr = schedule.cron.trim()
+    return {
+      schedule: { kind: 'cron', expr, display: expr },
+      scheduleDisplay: expr,
+      nextRunAt: null,
+    }
+  }
+  const minutes = parseRoutineEveryMinutes(schedule.interval)
+  if (minutes) {
+    const display = `every ${minutes}m`
+    return {
+      schedule: { kind: 'interval', minutes, display },
+      scheduleDisplay: display,
+      nextRunAt: addMinutesIso(minutes),
+    }
+  }
+  return null
+}
+
+function resolveShadowobRoutineDelivery(routine) {
+  const deliveries = Array.isArray(routine.deliveries) ? routine.deliveries : []
+  for (const delivery of deliveries) {
+    if (
+      !isPlainObject(delivery) ||
+      delivery.pluginId !== 'shadowob' ||
+      delivery.kind !== 'channel'
+    ) {
+      continue
+    }
+    const target = isPlainObject(delivery.target) ? delivery.target : {}
+    const channelEnvKey =
+      typeof target.channelEnvKey === 'string' && target.channelEnvKey.trim()
+        ? target.channelEnvKey.trim()
+        : null
+    const channelId =
+      (channelEnvKey ? process.env[channelEnvKey] : undefined) ??
+      (typeof target.channelId === 'string' ? target.channelId : undefined)
+    if (!channelId) continue
+    return {
+      channelId,
+      threadId:
+        typeof target.threadId === 'string' && target.threadId.trim()
+          ? target.threadId.trim()
+          : null,
+    }
+  }
+  return null
+}
+
+function managedRoutineJobId(routine) {
+  const raw = `shadow-template-${routine.agentId ?? 'agent'}-${routine.id ?? 'routine'}`
+    .toLowerCase()
+    .replace(/[^a-z0-9._:-]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+  if (raw.length >= 8 && raw.length <= 64) return raw
+  return `shadow-template-${stableHash({ agentId: routine.agentId, id: routine.id }).slice(0, 20)}`
+}
+
+function hermesManagedJobShape(job) {
+  return {
+    id: job.id,
+    name: job.name,
+    prompt: job.prompt,
+    skills: job.skills,
+    skill: job.skill,
+    model: job.model,
+    provider: job.provider,
+    base_url: job.base_url,
+    script: job.script,
+    no_agent: job.no_agent,
+    context_from: job.context_from,
+    schedule: job.schedule,
+    schedule_display: job.schedule_display,
+    repeat: job.repeat,
+    enabled: job.enabled,
+    state: job.state,
+    deliver: job.deliver,
+    origin: job.origin,
+    enabled_toolsets: job.enabled_toolsets,
+    workdir: job.workdir,
+    profile: job.profile,
+  }
+}
+
+function buildHermesRoutineJob(routine, now) {
+  if (
+    !isPlainObject(routine) ||
+    typeof routine.id !== 'string' ||
+    typeof routine.agentId !== 'string'
+  ) {
+    return null
+  }
+  const schedule = buildHermesRoutineSchedule(routine)
+  const delivery = resolveShadowobRoutineDelivery(routine)
+  if (!schedule || !delivery) return null
+
+  const origin = {
+    platform: 'shadowob',
+    chat_id: delivery.channelId,
+    ...(delivery.threadId ? { thread_id: delivery.threadId } : {}),
+  }
+  const job = {
+    id: managedRoutineJobId(routine),
+    name:
+      typeof routine.title === 'string' && routine.title.trim() ? routine.title.trim() : routine.id,
+    prompt: String(routine.prompt ?? ''),
+    skills: [],
+    skill: null,
+    model: null,
+    provider: null,
+    base_url: null,
+    script: null,
+    no_agent: false,
+    context_from: null,
+    schedule: schedule.schedule,
+    schedule_display: schedule.scheduleDisplay,
+    repeat: { times: null, completed: 0 },
+    enabled: routine.enabled !== false,
+    state: routine.enabled === false ? 'paused' : 'scheduled',
+    paused_at: null,
+    paused_reason: null,
+    created_at: now,
+    next_run_at: schedule.nextRunAt,
+    last_run_at: null,
+    last_status: null,
+    last_error: null,
+    last_delivery_error: null,
+    deliver: delivery.threadId ? 'origin' : `shadowob:${delivery.channelId}`,
+    origin,
+    enabled_toolsets: null,
+    workdir: '/workspace',
+    profile: null,
+  }
+  const managedSpecHash = stableHash(hermesManagedJobShape(job))
+  return {
+    ...job,
+    shadowTemplateRoutine: {
+      version: 1,
+      routineId: routine.id,
+      agentId: routine.agentId,
+      sourceHash: typeof routine.sourceHash === 'string' ? routine.sourceHash : null,
+      managedSpecHash,
+    },
+  }
+}
+
+function syncTemplateRoutinesToHermesCron() {
+  if (!existsSync(TEMPLATE_ROUTINES_PATH)) return
+  const seed = readJsonFile(TEMPLATE_ROUTINES_PATH, null)
+  const routines = Array.isArray(seed?.routines) ? seed.routines : []
+  if (routines.length === 0) return
+
+  const now = isoNow()
+  const store = readJsonFile(HERMES_CRON_STORE_PATH, { jobs: [] })
+  const jobs = Array.isArray(store.jobs) ? store.jobs.filter(Boolean) : []
+  let changed = false
+
+  for (const routine of routines) {
+    const desired = buildHermesRoutineJob(routine, now)
+    if (!desired) {
+      console.warn(
+        `[entrypoint] Skipping invalid template routine: ${JSON.stringify(routine?.id ?? null)}`,
+      )
+      continue
+    }
+    const existingIndex = jobs.findIndex((job) => {
+      const marker = isPlainObject(job?.shadowTemplateRoutine) ? job.shadowTemplateRoutine : null
+      return marker?.routineId === desired.shadowTemplateRoutine.routineId || job?.id === desired.id
+    })
+    if (existingIndex < 0) {
+      jobs.push(desired)
+      changed = true
+      console.log(`[entrypoint] Seeded Hermes cron routine: ${desired.id}`)
+      continue
+    }
+    const existing = jobs[existingIndex]
+    const marker = isPlainObject(existing.shadowTemplateRoutine)
+      ? existing.shadowTemplateRoutine
+      : null
+    const currentManagedSpecHash = stableHash(hermesManagedJobShape(existing))
+    if (!marker || marker.managedSpecHash !== currentManagedSpecHash) {
+      console.log(
+        `[entrypoint] Preserved user-edited Hermes cron routine: ${existing.id ?? desired.id}`,
+      )
+      continue
+    }
+    if (marker.managedSpecHash === desired.shadowTemplateRoutine.managedSpecHash) continue
+    jobs[existingIndex] = {
+      ...desired,
+      id: existing.id ?? desired.id,
+      created_at: existing.created_at ?? desired.created_at,
+      last_run_at: existing.last_run_at ?? null,
+      last_status: existing.last_status ?? null,
+      last_error: existing.last_error ?? null,
+      last_delivery_error: existing.last_delivery_error ?? null,
+    }
+    changed = true
+    console.log(`[entrypoint] Updated Hermes cron routine from template: ${jobs[existingIndex].id}`)
+  }
+
+  if (!changed) return
+  mkdirSync(dirname(HERMES_CRON_STORE_PATH), { recursive: true })
+  writeFileSync(HERMES_CRON_STORE_PATH, `${JSON.stringify({ jobs, updated_at: now }, null, 2)}\n`, {
+    encoding: 'utf-8',
+    mode: 0o600,
+  })
+  chmodSync(HERMES_CRON_STORE_PATH, 0o600)
+}
+
 function materializeRuntimeFiles() {
   const files = loadJson(RUNTIME_FILES_PATH, {})
   for (const [path, content] of Object.entries(files)) {
@@ -226,7 +493,7 @@ function startHermes() {
   const proc = spawn('hermes', ['gateway'], {
     env: {
       ...process.env,
-      HERMES_HOME: process.env.HERMES_HOME ?? join(RUNNER_HOME, '.hermes'),
+      HERMES_HOME,
     },
     stdio: ['ignore', 'pipe', 'pipe'],
     cwd: '/workspace',
@@ -262,6 +529,7 @@ async function main() {
   materializeRuntimeFiles()
   materializeCredentialFiles()
   materializePluginRuntimeAssets()
+  syncTemplateRoutinesToHermesCron()
 
   if (process.env.SHADOW_RUNNER_VALIDATE_ONLY === '1') {
     verifyBinary('hermes', ['--version'])

package/images/openclaw-runner/Dockerfile

@@ -61,6 +61,7 @@ RUN find node_modules -type d \( -name ".github" -o -name "test" -o -name "tests
 # TypeScript source changes.
 WORKDIR /workspace
 COPY package.json pnpm-lock.yaml pnpm-workspace.yaml tsconfig.json .npmrc ./
+COPY patches patches
 COPY packages/shared/package.json packages/shared/package.json
 COPY packages/sdk/package.json packages/sdk/package.json
 COPY packages/cli/package.json packages/cli/package.json

package/images/openclaw-runner/RUNNER.md

@@ -17,6 +17,9 @@ The current image already follows this model more closely than the ACP runners:
   ShadowOB connector CLI.
 - `entrypoint.mjs` reads `/etc/openclaw/config.json`.
 - Runtime extensions are read from `/etc/openclaw/runtime-extensions.json`.
+- Template routines are read from `/etc/shadowob/template-routines.json` and
+  synced into the OpenClaw cron store before the gateway starts. The sync keeps a
+  managed spec hash so runtime-edited jobs are preserved on redeploy.
 - The generated OpenClaw config is written outside mutable state by default.
 - File logging goes to `/var/log/openclaw/entrypoint.log`.
 - Shadow slash command artifacts are surfaced through

package/images/openclaw-runner/entrypoint.mjs

@@ -10,7 +10,7 @@
  */
 
 import { spawn, spawnSync } from 'node:child_process'
-import { randomBytes } from 'node:crypto'
+import { createHash, randomBytes } from 'node:crypto'
 import {
   chmodSync,
   cpSync,
@@ -33,6 +33,8 @@ const EXTENSIONS_DIR = '/app/extensions'
 const RUNTIME_FILES_PATH = join(CONFIG_MOUNT, 'runtime-files.json')
 const RUNTIME_EXTENSIONS_PATH = join(CONFIG_MOUNT, 'runtime-extensions.json')
 const DEFAULT_SHADOW_SLASH_COMMANDS_PATH = '/etc/shadowob/slash-commands.json'
+const TEMPLATE_ROUTINES_PATH =
+  process.env.SHADOW_TEMPLATE_ROUTINES_PATH ?? '/etc/shadowob/template-routines.json'
 const RUNTIME_CONFIG_DIR = process.env.OPENCLAW_RUNTIME_CONFIG_DIR || '/tmp/openclaw/config'
 const RUNTIME_CONFIG_PATH = join(RUNTIME_CONFIG_DIR, 'openclaw.json')
 const OPENCLAW_PACKAGE_DIR = '/app/node_modules/openclaw'
@@ -245,6 +247,251 @@ function materializeCredentialFiles(runtimeExtensions) {
   }
 }
 
+function stableValue(value) {
+  if (Array.isArray(value)) return value.map(stableValue)
+  if (!isPlainObject(value)) return value
+  return Object.fromEntries(
+    Object.entries(value)
+      .sort(([left], [right]) => left.localeCompare(right))
+      .map(([key, item]) => [key, stableValue(item)]),
+  )
+}
+
+function stableHash(value) {
+  return createHash('sha256')
+    .update(JSON.stringify(stableValue(value)))
+    .digest('hex')
+}
+
+function readJsonFile(path, fallback) {
+  if (!existsSync(path)) return fallback
+  try {
+    const parsed = JSON.parse(readFileSync(path, 'utf-8'))
+    return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : fallback
+  } catch (err) {
+    console.warn(`[entrypoint] Failed to parse ${path}: ${err.message}`)
+    return fallback
+  }
+}
+
+function resolveRunnerHomePath(rawPath) {
+  if (typeof rawPath !== 'string' || !rawPath.trim()) return null
+  const trimmed = rawPath.trim()
+  if (trimmed === '~') return RUNNER_HOME
+  if (trimmed.startsWith('~/')) return join(RUNNER_HOME, trimmed.slice(2))
+  return resolve(trimmed)
+}
+
+function resolveOpenClawCronStorePath(openclawConfig) {
+  const configured = isPlainObject(openclawConfig.cron) ? openclawConfig.cron.store : undefined
+  const candidate =
+    resolveRunnerHomePath(configured) ?? join(OPENCLAW_STATE_DIR, 'cron', 'jobs.json')
+  const allowedRoots = [RUNNER_HOME, '/home/openclaw']
+  if (!allowedRoots.some((root) => candidate === root || candidate.startsWith(`${root}/`))) {
+    console.warn(
+      `[entrypoint] Skipping template routine sync; cron store outside runner home: ${candidate}`,
+    )
+    return null
+  }
+  return candidate
+}
+
+function parseRoutineEveryMs(interval) {
+  if (typeof interval !== 'string') return null
+  const match = interval.trim().match(/^(\d+)\s*(s|m|h|d)$/i)
+  if (!match) return null
+  const amount = Number.parseInt(match[1], 10)
+  if (!Number.isFinite(amount) || amount <= 0) return null
+  const unit = match[2].toLowerCase()
+  const multiplier =
+    unit === 's' ? 1000 : unit === 'm' ? 60_000 : unit === 'h' ? 3_600_000 : 86_400_000
+  return amount * multiplier
+}
+
+function buildOpenClawRoutineSchedule(routine) {
+  const schedule = isPlainObject(routine.schedule) ? routine.schedule : {}
+  if (typeof schedule.cron === 'string' && schedule.cron.trim()) {
+    return {
+      kind: 'cron',
+      expr: schedule.cron.trim(),
+      ...(typeof schedule.timezone === 'string' && schedule.timezone.trim()
+        ? { tz: schedule.timezone.trim() }
+        : {}),
+    }
+  }
+  const everyMs = parseRoutineEveryMs(schedule.interval)
+  if (everyMs) return { kind: 'every', everyMs }
+  return null
+}
+
+function resolveRoutineDeliveryTarget(delivery) {
+  if (!isPlainObject(delivery) || delivery.pluginId !== 'shadowob' || delivery.kind !== 'channel') {
+    return null
+  }
+  const target = isPlainObject(delivery.target) ? delivery.target : {}
+  const channelEnvKey =
+    typeof target.channelEnvKey === 'string' && target.channelEnvKey.trim()
+      ? target.channelEnvKey.trim()
+      : null
+  const channelId =
+    (channelEnvKey ? process.env[channelEnvKey] : undefined) ??
+    (typeof target.channelId === 'string' ? target.channelId : undefined)
+  if (!channelId) return null
+  return {
+    mode: 'announce',
+    channel: 'shadowob',
+    to: `shadowob:channel:${channelId}`,
+    ...(typeof target.threadId === 'string' && target.threadId.trim()
+      ? { threadId: target.threadId.trim() }
+      : {}),
+    ...(typeof target.accountId === 'string' && target.accountId.trim()
+      ? { accountId: target.accountId.trim() }
+      : {}),
+    bestEffort: true,
+  }
+}
+
+function managedRoutineJobId(routine) {
+  const raw = `shadow-template-${routine.agentId ?? 'agent'}-${routine.id ?? 'routine'}`
+    .toLowerCase()
+    .replace(/[^a-z0-9._:-]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+  if (raw.length >= 12 && raw.length <= 96) return raw
+  return `shadow-template-${stableHash({ agentId: routine.agentId, id: routine.id }).slice(0, 24)}`
+}
+
+function openClawManagedJobShape(job) {
+  return {
+    agentId: job.agentId,
+    sessionKey: job.sessionKey,
+    name: job.name,
+    description: job.description,
+    enabled: job.enabled,
+    deleteAfterRun: job.deleteAfterRun,
+    schedule: job.schedule,
+    sessionTarget: job.sessionTarget,
+    wakeMode: job.wakeMode,
+    payload: job.payload,
+    delivery: job.delivery,
+  }
+}
+
+function buildOpenClawRoutineJob(routine, now) {
+  if (
+    !isPlainObject(routine) ||
+    typeof routine.id !== 'string' ||
+    typeof routine.agentId !== 'string'
+  ) {
+    return null
+  }
+  const schedule = buildOpenClawRoutineSchedule(routine)
+  if (!schedule) return null
+  const delivery = Array.isArray(routine.deliveries)
+    ? routine.deliveries.map(resolveRoutineDeliveryTarget).find(Boolean)
+    : null
+  if (!delivery) return null
+  const job = {
+    id: managedRoutineJobId(routine),
+    agentId: routine.agentId,
+    name:
+      typeof routine.title === 'string' && routine.title.trim() ? routine.title.trim() : routine.id,
+    description:
+      typeof routine.description === 'string' && routine.description.trim()
+        ? routine.description.trim()
+        : `Shadow Cloud template routine ${routine.id}`,
+    enabled: routine.enabled !== false,
+    createdAtMs: now,
+    updatedAtMs: now,
+    schedule,
+    sessionTarget: 'isolated',
+    wakeMode: 'now',
+    payload: { kind: 'agentTurn', message: String(routine.prompt ?? '') },
+    delivery,
+    state: {},
+  }
+  const managedSpecHash = stableHash(openClawManagedJobShape(job))
+  return {
+    ...job,
+    shadowTemplateRoutine: {
+      version: 1,
+      routineId: routine.id,
+      agentId: routine.agentId,
+      sourceHash: typeof routine.sourceHash === 'string' ? routine.sourceHash : null,
+      managedSpecHash,
+    },
+  }
+}
+
+function syncTemplateRoutinesToOpenClawCron(openclawConfig) {
+  if (!existsSync(TEMPLATE_ROUTINES_PATH)) return
+  const seed = readJsonFile(TEMPLATE_ROUTINES_PATH, null)
+  const routines = Array.isArray(seed?.routines) ? seed.routines : []
+  if (routines.length === 0) return
+
+  const storePath = resolveOpenClawCronStorePath(openclawConfig)
+  if (!storePath) return
+
+  const now = Date.now()
+  const store = readJsonFile(storePath, { version: 1, jobs: [] })
+  const jobs = Array.isArray(store.jobs) ? store.jobs.filter(Boolean) : []
+  let changed = false
+
+  for (const routine of routines) {
+    const desired = buildOpenClawRoutineJob(routine, now)
+    if (!desired) {
+      console.warn(
+        `[entrypoint] Skipping invalid template routine: ${JSON.stringify(routine?.id ?? null)}`,
+      )
+      continue
+    }
+
+    const existingIndex = jobs.findIndex((job) => {
+      const marker = isPlainObject(job?.shadowTemplateRoutine) ? job.shadowTemplateRoutine : null
+      return marker?.routineId === desired.shadowTemplateRoutine.routineId || job?.id === desired.id
+    })
+
+    if (existingIndex < 0) {
+      jobs.push(desired)
+      changed = true
+      console.log(`[entrypoint] Seeded OpenClaw cron routine: ${desired.id}`)
+      continue
+    }
+
+    const existing = jobs[existingIndex]
+    const marker = isPlainObject(existing.shadowTemplateRoutine)
+      ? existing.shadowTemplateRoutine
+      : null
+    const currentManagedSpecHash = stableHash(openClawManagedJobShape(existing))
+    if (!marker || marker.managedSpecHash !== currentManagedSpecHash) {
+      console.log(
+        `[entrypoint] Preserved user-edited OpenClaw cron routine: ${existing.id ?? desired.id}`,
+      )
+      continue
+    }
+
+    if (marker.managedSpecHash === desired.shadowTemplateRoutine.managedSpecHash) continue
+    jobs[existingIndex] = {
+      ...desired,
+      id: existing.id ?? desired.id,
+      createdAtMs: existing.createdAtMs ?? desired.createdAtMs,
+      updatedAtMs: now,
+      state: isPlainObject(existing.state) ? existing.state : {},
+    }
+    changed = true
+    console.log(
+      `[entrypoint] Updated OpenClaw cron routine from template: ${jobs[existingIndex].id}`,
+    )
+  }
+
+  if (!changed) return
+  mkdirSync(dirname(storePath), { recursive: true })
+  writeFileSync(storePath, `${JSON.stringify({ version: 1, jobs }, null, 2)}\n`, {
+    encoding: 'utf-8',
+    mode: 0o600,
+  })
+  chmodSync(storePath, 0o600)
+}
+
 function resolveEnvVars(obj) {
   if (typeof obj === 'string') {
     return obj.replace(/\$\{env:([^}]+)\}/g, (_, key) => {
@@ -1061,6 +1308,7 @@ async function main() {
   }
   writeFileSync(configPath, JSON.stringify(openclawConfig, null, 2), 'utf-8')
   console.log('[entrypoint] Runtime config restored after setup')
+  syncTemplateRoutinesToOpenClawCron(openclawConfig)
 
   // 2e. Overlay workspace files from ConfigMap (SOUL.md, AGENTS.md, etc.)
   // These are agent-specific files generated by the cloud config builder that

package/images/openclaw-runner/warm-runtime-deps.mjs

@@ -63,9 +63,7 @@ async function main() {
   })
 
   if (scan.conflicts.length > 0) {
-    console.warn(
-      `[runtime-deps] ${scan.conflicts.length} bundled dependency conflict(s) detected`,
-    )
+    console.warn(`[runtime-deps] ${scan.conflicts.length} bundled dependency conflict(s) detected`)
   }
 
   if (scan.missing.length === 0) {

package/images/opencode-runner/RUNNER.md

@@ -145,9 +145,11 @@ type = "shadowob"
 - Skills: materialize `.opencode/skills` first; optionally also emit
   `.agents/skills` if a workflow must be shared with Codex.
 - MCP: write the OpenCode `mcp` object, not OpenClaw `mcp`.
-- Cron/routine: OpenCode does not provide the same native cron surface as
-  OpenClaw or Hermes in the researched docs; Cloud should own scheduling for
-  phase 1.
+- Cron/routine: Cloud template routines are materialized by the shared
+  cc-connect runner from `/etc/shadowob/template-routines.json` into
+  `~/.cc-connect/crons/jobs.json`. Managed jobs use deterministic ids and a
+  spec hash so user-edited schedules are preserved. ShadowOB delivery uses
+  `session_key = "shadowob:channel:<channel_id>"` or a thread-qualified variant.
 - Hooks: prefer OpenCode plugins for deterministic lifecycle behavior.
 - Subagents: use OpenCode `agent` and command `subtask` config instead of
   OpenClaw multi-agent routing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shadowob/cloud",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "shadowob-cloud — deploy AI agents to Kubernetes",
   "type": "module",
   "bin": {
@@ -58,8 +58,8 @@
     "yaml": "^2.8.4",
     "zod": "^3.25.76",
     "zustand": "^5.0.13",
-    "@shadowob/sdk": "1.1.7",
-    "@shadowob/shared": "1.1.7"
+    "@shadowob/sdk": "1.1.9",
+    "@shadowob/shared": "1.1.9"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/agent-marketplace-buddy.template.json

@@ -49,7 +49,10 @@
             "channels": ["choose", "build", "review"],
             "agentId": "agent-marketplace-buddy"
           }
-        ]
+        ],
+        "greeting": {
+          "entryChannelId": "choose"
+        }
       }
     }
   ],

package/templates/bmad-method-buddy.template.json

@@ -49,7 +49,10 @@
             "channels": ["analysis", "planning", "delivery"],
             "agentId": "bmad-buddy"
           }
-        ]
+        ],
+        "greeting": {
+          "entryChannelId": "delivery"
+        }
       }
     }
   ],