@jc_stack/ez-agents 0.1.0-beta.25 → 0.1.0-beta.26

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.1.0-beta.26
+
+- Start local software-maintenance wakeups in independent ephemeral sessions,
+  including after a relay restart, without trying to resume or persist a
+  normal owner conversation. This prevents successful upgrades from producing
+  false "failed to start" notifications across direct relays.
+
 ## 0.1.0-beta.25
 
 - Enable Codex Luna `max` reasoning for durable work, schedules and deferred

package/docs/releasing.md

@@ -17,8 +17,9 @@ separate release bot is not required.
 3. Build both Docker targets from a clean checkout:
    `docker build --target test -t ez-release-tests .` and
    `docker build --target runtime -t ez-release-runtime .`.
-   Main: `EZ_RELAY_IMAGE=ez-release-runtime node docker/smoke.mjs`.
-   WhatsApp: `EZ_WHATSAPP_IMAGE=ez-release-runtime node docker/smoke.mjs`.
+   Main relay: `EZ_RELAY_IMAGE=ez-release-runtime node docker/smoke.mjs`.
+   The WhatsApp Compose overlay has no separate relay image; verify its
+   provider integration with the synthetic plugin smoke in `docs/plugins.md`.
 4. Create an artifact with `npm pack --ignore-scripts`. Inspect its file list,
    hash it, extract into a fresh directory, copy `docker/pnpm-lock.yaml` to
    `pnpm-lock.yaml`, and run `pnpm install --frozen-lockfile`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jc_stack/ez-agents",
-  "version": "0.1.0-beta.25",
+  "version": "0.1.0-beta.26",
   "private": false,
   "type": "module",
   "description": "A lightweight foundation for persistent business AI assistants using existing AI harnesses, workspaces and plugins.",

package/src/index.ts

@@ -193,7 +193,9 @@ export const createRelay = (config: Config, launch = startExecutorJob) => {
         const launchStarted = performance.now()
         const started = await runs.patch(run.id, { status: 'running', startedAt: new Date().toISOString() })
         if (!started.execution && !run.taskId) throw new Error('Legacy queued work has no pinned AI. Resend the request after /new.')
-        const session = run.external || run.taskId || run.scheduled || run.replyOnly
+        const maintenanceWakeup = run.id.startsWith('r_update_')
+        const startsOwnSession = Boolean(run.external || run.taskId || run.scheduled || run.replyOnly || maintenanceWakeup)
+        const session = startsOwnSession
           ? { sessionId: randomUUID(), hasStarted: false, nativeSessionId: undefined }
           : await control.executionSession(started.execution!)
         const selected = run.taskId ? chatPreset('codex') : started.execution!.preset
@@ -211,7 +213,7 @@ export const createRelay = (config: Config, launch = startExecutorJob) => {
           sessionId: session.nativeSessionId || session.sessionId,
           isResume: session.hasStarted,
           eventSource: run.external?.sourceId,
-          onSession: run.external || run.taskId || run.replyOnly ? undefined : async (id) => { await runs.patch(run.id,{nativeSessionId:id}); if (!run.scheduled) await control.saveNativeSession(session.sessionId,id) },
+          onSession: run.external || run.taskId || run.replyOnly || maintenanceWakeup ? undefined : async (id) => { await runs.patch(run.id,{nativeSessionId:id}); if (!run.scheduled) await control.saveNativeSession(session.sessionId,id) },
         })
         const executionStarted = performance.now()
         // Attach before disk writes: a fast child can close while PID persistence

package/test/scheduler-relay.test.ts

@@ -11,8 +11,33 @@ import { ControlStore } from '../src/control-state.js'
 import { RunStore } from '../src/runs.js'
 import { Scheduler } from '../src/scheduler.js'
 import { initialPreset } from '../src/ai.js'
+import { randomUUID } from 'node:crypto'
 
 const until=async(check:()=>Promise<boolean>)=>{for(let i=0;i<200;i++){if(await check())return;await new Promise(r=>setTimeout(r,20))}throw new Error('Timed out')}
+
+test('maintenance wakeups use an independent ephemeral session after a relay restart',async()=>{
+ const dir=await mkdtemp(join(tmpdir(),'ez-maintenance-session-')),control=new ControlStore(dir,1000),runs=new RunStore(dir)
+ let launchSession='',onSessionCalls=0
+ const relay=createRelay({workspace:dir,controlDir:dir,pairingTtlMs:1000,executorTimeoutMs:0,executorCli:'codex',telegramBotToken:'fixture'},async(_texts,options)=>{
+  launchSession=options.sessionId ?? ''
+  if(options.onSession){onSessionCalls++;await options.onSession('native-maintenance')}
+  const child=spawn(process.execPath,['-e','setTimeout(()=>{},10)'],{detached:process.platform!=='win32'})
+  await once(child,'spawn')
+  return {child,cleanup:async()=>{},stdout:''}
+ })
+ relay.bot.botInfo={id:999,is_bot:true,first_name:'Fixture',username:'fixture_bot'} as typeof relay.bot.botInfo
+ relay.bot.api.config.use(async()=>({ok:true,result:{message_id:42}}) as never)
+ try{
+  await control.requestPairing(101,101);await control.approveOwner(101)
+  const execution={sessionId:randomUUID(),preset:initialPreset('codex')}
+  await runs.create({id:'r_update_fixture',chatId:101,telegramUserId:101,texts:['maintenance'],execution})
+  await relay.drainSources()
+  await until(async()=> (await runs.get('r_update_fixture'))?.status==='completed')
+  assert.notEqual(launchSession,execution.sessionId)
+  assert.equal(onSessionCalls,0)
+}finally{await relay.stop();await rm(dir,{recursive:true,force:true})}
+})
+
 test('chat replies through the real ingress/outbox while scheduled CLI remains alive; targeted cancellation',async()=>{
  const dir=await mkdtemp(join(tmpdir(),'ez-scheduler-relay-')), children:ReturnType<typeof spawn>[]=[]
  const runs=new RunStore(dir),scheduler=new Scheduler(dir),control=new ControlStore(dir,1000)