zooid 0.14.1 → 0.16.0

package/src/observability/lifecycle-log.ts

@@ -0,0 +1,29 @@
+import type { SessionLifecycleEvent } from '@zooid/core'
+
+/**
+ * One grep-able line per ACP session lifecycle event, for `zooid start`'s
+ * stdout/stderr ([ZOD089]). Carries identities and outcomes only — never
+ * prompt or transcript content. Skipped: `unsupported` (the ACP client
+ * already warns once per agent) and `cached` recoveries, which fire on every
+ * prompt to a live session and would add a line per message.
+ */
+export function formatLifecycleLine(agentName: string, event: SessionLifecycleEvent): string | null {
+  if (event.outcome === 'unsupported') return null
+  if (event.recoveryMethod === 'cached') return null
+  const what =
+    event.outcome === 'recovered'
+      ? `recovered (${event.recoveryMethod ?? 'unknown'})`
+      : `${event.reason ?? 'close'} → ${event.outcome}`
+  return `[lifecycle] ${agentName} key=${event.sessionKey} session=${event.sessionId} ${what}`
+}
+
+export function logLifecycle(
+  agentName: string,
+  event: SessionLifecycleEvent,
+  out: Pick<Console, 'log' | 'error'> = console,
+): void {
+  const line = formatLifecycleLine(agentName, event)
+  if (!line) return
+  if (event.outcome === 'failed') out.error(line)
+  else out.log(line)
+}

package/src/observability/observability.integration.test.ts

@@ -16,6 +16,28 @@ describe('agent capture end-to-end', () => {
     rmSync(dataDir, { recursive: true, force: true })
   })
 
+  it('captures lifecycle identity and counts only successful reclamation', async () => {
+    const now = new Date('2026-05-06T10:00:00Z')
+    const paths = resolveLogPaths({ dataDir, now })
+    await ensureDayFolder(paths)
+    const cap = wireAgentCapture({ agent: 'docs', paths, verbosity: 'default', matrixContext: () => null, now: () => now })
+    cap.onLifecycle({ agentId: 'docs', sessionKey: 'root', sessionId: 's1', outcome: 'recovered', recoveryMethod: 'new' })
+    cap.onLifecycle({ agentId: 'docs', sessionKey: 'root', sessionId: 's1', reason: 'idle', outcome: 'closed' })
+    cap.onLifecycle({ agentId: 'docs', sessionKey: 'root', sessionId: 's1', outcome: 'recovered', recoveryMethod: 'resume' })
+    cap.onLifecycle({ agentId: 'docs', sessionKey: 'root', sessionId: 's1', reason: 'clear', outcome: 'failed' })
+    expect(cap.readLifecycleCounters()).toEqual({
+      closeAttempts: 2,
+      closeSuccesses: 1,
+      sessionsReclaimed: 1,
+      recoveries: { cached: 0, resume: 1, load: 0, new: 1 },
+    })
+    await cap.close()
+    const rows = (await readFile(paths.agentTap('docs'), 'utf8')).trim().split('\n').map((line) => JSON.parse(line))
+    expect(rows).toHaveLength(4)
+    expect(rows[1]).toMatchObject({ kind: 'session_lifecycle', session_key: 'root', session_id: 's1', reason: 'idle', outcome: 'closed' })
+    expect(rows[1]).not.toHaveProperty('prompt_text')
+  })
+
   it('writes one JSONL line per tap event with envelope + turn correlation', async () => {
     const now = new Date('2026-05-06T10:00:00Z')
     const paths = resolveLogPaths({ dataDir, now })

package/src/web/static.test.ts

@@ -64,6 +64,20 @@ describe('webStatic', () => {
     })
   })
 
+  it('serves workforce_space when configured, default or custom', async () => {
+    for (const space of ['dev', 'hq']) {
+      const app = webStatic({
+        webRoot: dir,
+        homeserverUrl: 'http://localhost:8448',
+        workforceSpace: space,
+      })
+      expect(await (await app.request('/config.json')).json()).toEqual({
+        homeserver_url: 'http://localhost:8448',
+        workforce_space: space,
+      })
+    }
+  })
+
   it('omits both when unconfigured, so the client falls back instead of half-subscribing', async () => {
     const app = webStatic({ webRoot: dir, homeserverUrl: 'http://localhost:8448' })
     expect(await (await app.request('/config.json')).json()).toEqual({

package/src/web/static.ts

@@ -5,6 +5,8 @@ import { Hono } from 'hono'
 export interface WebStaticOpts {
   webRoot: string
   homeserverUrl: string
+  /** Workforce space alias localpart, copied from `matrix.space`. */
+  workforceSpace?: string
   pushGatewayUrl?: string
   vapidPublicKey?: string
 }
@@ -33,6 +35,7 @@ export function webStatic(opts: WebStaticOpts): Hono {
   app.get('/config.json', (c) =>
     c.json({
       homeserver_url: opts.homeserverUrl,
+      ...(opts.workforceSpace ? { workforce_space: opts.workforceSpace } : {}),
       ...(opts.pushGatewayUrl ? { push_gateway_url: opts.pushGatewayUrl } : {}),
       ...(opts.vapidPublicKey ? { vapid_public_key: opts.vapidPublicKey } : {}),
     }),