@autohq/cli 0.1.342 → 0.1.343

package/dist/agent-bridge.js

@@ -19833,12 +19833,24 @@ var RuntimeBridgeOutputUiMessageCompletedEnvelopeSchema = external_exports.objec
   createdAt: external_exports.string().datetime(),
   completedAt: external_exports.string().datetime().nullable()
 });
+var RuntimeBridgeOutputLivenessEnvelopeSchema = external_exports.object({
+  type: external_exports.literal("runtime.liveness"),
+  sessionId: SessionIdSchema,
+  runtimeId: RuntimeIdSchema,
+  bridgeLeaseId: RuntimeBridgeLeaseIdSchema,
+  outputSeq: external_exports.number().int().positive(),
+  // The emitter's beat cadence, so watchdog thresholds stay interpretable
+  // against the runtime that produced them.
+  intervalMs: external_exports.number().int().positive(),
+  createdAt: external_exports.string().datetime()
+});
 var RuntimeBridgeOutputEnvelopeSchema = external_exports.union([
   RuntimeBridgeOutputEntryEnvelopeSchema,
   RuntimeBridgeOutputDeltaEnvelopeSchema,
   RuntimeBridgeOutputUiMessageChunkEnvelopeSchema,
   RuntimeBridgeOutputUiMessagePartEnvelopeSchema,
-  RuntimeBridgeOutputUiMessageCompletedEnvelopeSchema
+  RuntimeBridgeOutputUiMessageCompletedEnvelopeSchema,
+  RuntimeBridgeOutputLivenessEnvelopeSchema
 ]);
 function isLiveOnlyRuntimeOutputEnvelope(envelope) {
   return envelope.type === "ui.message.chunk" || envelope.type === "conversation.delta";
@@ -23480,7 +23492,7 @@ Object.assign(lookup, {
 // package.json
 var package_default = {
   name: "@autohq/cli",
-  version: "0.1.342",
+  version: "0.1.343",
   license: "SEE LICENSE IN README.md",
   publishConfig: {
     access: "public"
@@ -28506,6 +28518,10 @@ var SessionTurnRecordSchema = external_exports.object({
   acceptedAt: external_exports.string().datetime().nullable(),
   startedAt: external_exports.string().datetime().nullable(),
   lastProgressAt: external_exports.string().datetime().nullable(),
+  // Last runtime liveness beat that vouched for this open turn (null before
+  // the first beat, and always null on runtimes that predate liveness).
+  // Distinct from lastProgressAt: pipeline liveness, not durable progress.
+  livenessAt: external_exports.string().datetime().nullable().default(null),
   completedAt: external_exports.string().datetime().nullable(),
   failedAt: external_exports.string().datetime().nullable(),
   staleAt: external_exports.string().datetime().nullable(),
@@ -35863,6 +35879,23 @@ var ProjectUsageResponseSchema = external_exports.object({
   daily: external_exports.array(ProjectUsageDayPointSchema)
 });
 
+// src/commands/agent-bridge/harness/liveness-ticker.ts
+var RUNTIME_LIVENESS_INTERVAL_MS = 2e4;
+function startRuntimeLivenessTicker(input) {
+  const intervalMs = input.intervalMs ?? RUNTIME_LIVENESS_INTERVAL_MS;
+  const timer = setInterval(() => {
+    void input.emitBeat().catch((error51) => {
+      input.writeOutput?.(
+        `agent_bridge_liveness_beat_failed error=${error51 instanceof Error ? error51.message : String(error51)}`
+      );
+    });
+  }, intervalMs);
+  timer.unref?.();
+  return {
+    stop: () => clearInterval(timer)
+  };
+}
+
 // src/commands/agent-bridge/harness/output-buffer.ts
 import { setTimeout as sleep } from "timers/promises";
 
@@ -44514,6 +44547,9 @@ var AgentBridgeOutputBuffer = class {
   uiMessagePartTracker = new UiMessagePartTracker();
   drainBlocked = false;
   drainPromise = null;
+  // Sequence of the most recent liveness beat, for the skip-while-pending
+  // gate in emitLivenessBeat.
+  pendingLivenessSeq = null;
   // Ack-retry-ladder exhausts per pending output sequence, for the poison
   // quarantine; entries clear when the sequence finally acks.
   ackExhaustsBySeq = /* @__PURE__ */ new Map();
@@ -44544,6 +44580,29 @@ var AgentBridgeOutputBuffer = class {
     await this.flushPendingDelta({ force: true });
     await this.drainPendingOutputs({ force: true });
   }
+  // Emits one runtime liveness beat through the same ordered, acked drain as
+  // content envelopes — deliberately, so a beat landing at the bridge proves
+  // the pipeline is healthy end to end. While a previous beat is still
+  // pending (stalled drain, retry ladder, reconnect) new beats are skipped
+  // rather than queued: an unhealthy pipeline must show up as beats
+  // *stopping*, and a backlog of parked beats replaying after recovery would
+  // stamp liveness for exactly the window the runtime was mute.
+  async emitLivenessBeat(context, intervalMs) {
+    if (this.pendingLivenessSeq !== null && this.pendingOutputs.has(this.pendingLivenessSeq)) {
+      return;
+    }
+    this.outputSeq += 1;
+    this.pendingLivenessSeq = this.outputSeq;
+    this.enqueueOutput(
+      buildLivenessOutputEnvelope({
+        context,
+        outputSeq: this.outputSeq,
+        intervalMs,
+        createdAt: now2()
+      })
+    );
+    await this.drainPendingOutputs();
+  }
   async emitUiMessageChunk(context, projection) {
     await this.flushPendingDelta();
     await this.emitLiveUiMessageChunk(context, projection.chunk);
@@ -45240,6 +45299,18 @@ function buildUiMessageChunkOutputEnvelope(input) {
     createdAt: input.createdAt
   });
 }
+function buildLivenessOutputEnvelope(input) {
+  const { context } = input;
+  return RuntimeBridgeOutputEnvelopeSchema.parse({
+    type: "runtime.liveness",
+    sessionId: context.sessionId,
+    runtimeId: context.runtimeId,
+    bridgeLeaseId: context.bridgeLeaseId,
+    outputSeq: input.outputSeq,
+    intervalMs: input.intervalMs,
+    createdAt: input.createdAt
+  });
+}
 function buildUiMessagePartOutputEnvelope(input) {
   const { context, snapshot } = input;
   return RuntimeBridgeOutputEnvelopeSchema.parse({
@@ -66496,11 +66567,16 @@ var ClaudeCodeCommandHandler = class {
   pendingQuestions = /* @__PURE__ */ new Map();
   outputBuffer;
   projector = new ClaudeCodeProjector();
+  livenessTicker = null;
   // -----------------------------------------------------------------------------
   // Lifecycle (public API)
   // -----------------------------------------------------------------------------
   setContext(nextContext) {
     this.context = RuntimeBridgeConnectedPayloadSchema.parse(nextContext);
+    this.livenessTicker ??= startRuntimeLivenessTicker({
+      emitBeat: () => this.emitLivenessBeat(),
+      writeOutput: this.input.writeOutput
+    });
   }
   async replayPendingOutputs() {
     await this.outputBuffer.replayPendingOutputs();
@@ -66509,6 +66585,8 @@ var ClaudeCodeCommandHandler = class {
     await this.ensureAgentSession().prepare();
   }
   shutdown() {
+    this.livenessTicker?.stop();
+    this.livenessTicker = null;
     this.agentSession?.close();
     this.agentSession = null;
     this.settlePendingQuestions("Runtime is shutting down");
@@ -66840,6 +66918,16 @@ var ClaudeCodeCommandHandler = class {
   // -----------------------------------------------------------------------------
   // SDK callbacks
   // -----------------------------------------------------------------------------
+  async emitLivenessBeat() {
+    const activeContext = this.context;
+    if (!activeContext) {
+      return;
+    }
+    await this.outputBuffer.emitLivenessBeat(
+      activeContext,
+      RUNTIME_LIVENESS_INTERVAL_MS
+    );
+  }
   async emitBridgeOutput(activeContext, projection) {
     try {
       await this.outputBuffer.emitProjection(activeContext, projection);
@@ -68301,12 +68389,17 @@ var CodexCommandHandler = class {
   pendingApprovals = /* @__PURE__ */ new Map();
   outputBuffer;
   projector = new CodexProjector();
+  livenessTicker = null;
   skipResumeForNextSession = false;
   // ---------------------------------------------------------------------------
   // Lifecycle (public API)
   // ---------------------------------------------------------------------------
   setContext(nextContext) {
     this.context = RuntimeBridgeConnectedPayloadSchema.parse(nextContext);
+    this.livenessTicker ??= startRuntimeLivenessTicker({
+      emitBeat: () => this.emitLivenessBeat(),
+      writeOutput: this.input.writeOutput
+    });
   }
   async replayPendingOutputs() {
     await this.outputBuffer.replayPendingOutputs();
@@ -68315,6 +68408,8 @@ var CodexCommandHandler = class {
     await this.ensureSession().prepare();
   }
   shutdown() {
+    this.livenessTicker?.stop();
+    this.livenessTicker = null;
     this.session?.close();
     this.session = null;
     this.pendingApprovals.clear();
@@ -68482,6 +68577,16 @@ var CodexCommandHandler = class {
       this.projector.projectSessionFailure(errorMessage3(error51))
     );
   }
+  async emitLivenessBeat() {
+    const activeContext = this.context;
+    if (!activeContext) {
+      return;
+    }
+    await this.outputBuffer.emitLivenessBeat(
+      activeContext,
+      RUNTIME_LIVENESS_INTERVAL_MS
+    );
+  }
   async emit(activeContext, projection) {
     try {
       await this.outputBuffer.emitProjection(activeContext, projection);

package/dist/index.js

@@ -20227,6 +20227,10 @@ var init_session_turns = __esm({
       acceptedAt: external_exports.string().datetime().nullable(),
       startedAt: external_exports.string().datetime().nullable(),
       lastProgressAt: external_exports.string().datetime().nullable(),
+      // Last runtime liveness beat that vouched for this open turn (null before
+      // the first beat, and always null on runtimes that predate liveness).
+      // Distinct from lastProgressAt: pipeline liveness, not durable progress.
+      livenessAt: external_exports.string().datetime().nullable().default(null),
       completedAt: external_exports.string().datetime().nullable(),
       failedAt: external_exports.string().datetime().nullable(),
       staleAt: external_exports.string().datetime().nullable(),
@@ -30499,7 +30503,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@autohq/cli",
-      version: "0.1.342",
+      version: "0.1.343",
       license: "SEE LICENSE IN README.md",
       publishConfig: {
         access: "public"
@@ -40758,12 +40762,24 @@ var RuntimeBridgeOutputUiMessageCompletedEnvelopeSchema = external_exports.objec
   createdAt: external_exports.string().datetime(),
   completedAt: external_exports.string().datetime().nullable()
 });
+var RuntimeBridgeOutputLivenessEnvelopeSchema = external_exports.object({
+  type: external_exports.literal("runtime.liveness"),
+  sessionId: SessionIdSchema2,
+  runtimeId: RuntimeIdSchema2,
+  bridgeLeaseId: RuntimeBridgeLeaseIdSchema2,
+  outputSeq: external_exports.number().int().positive(),
+  // The emitter's beat cadence, so watchdog thresholds stay interpretable
+  // against the runtime that produced them.
+  intervalMs: external_exports.number().int().positive(),
+  createdAt: external_exports.string().datetime()
+});
 var RuntimeBridgeOutputEnvelopeSchema = external_exports.union([
   RuntimeBridgeOutputEntryEnvelopeSchema,
   RuntimeBridgeOutputDeltaEnvelopeSchema,
   RuntimeBridgeOutputUiMessageChunkEnvelopeSchema,
   RuntimeBridgeOutputUiMessagePartEnvelopeSchema,
-  RuntimeBridgeOutputUiMessageCompletedEnvelopeSchema
+  RuntimeBridgeOutputUiMessageCompletedEnvelopeSchema,
+  RuntimeBridgeOutputLivenessEnvelopeSchema
 ]);
 function isLiveOnlyRuntimeOutputEnvelope(envelope) {
   return envelope.type === "ui.message.chunk" || envelope.type === "conversation.delta";
@@ -41278,6 +41294,23 @@ function jsonRecordString(value, key) {
 // src/commands/agent-bridge/harness/claude-code/index.ts
 init_src();
 
+// src/commands/agent-bridge/harness/liveness-ticker.ts
+var RUNTIME_LIVENESS_INTERVAL_MS = 2e4;
+function startRuntimeLivenessTicker(input) {
+  const intervalMs = input.intervalMs ?? RUNTIME_LIVENESS_INTERVAL_MS;
+  const timer = setInterval(() => {
+    void input.emitBeat().catch((error51) => {
+      input.writeOutput?.(
+        `agent_bridge_liveness_beat_failed error=${error51 instanceof Error ? error51.message : String(error51)}`
+      );
+    });
+  }, intervalMs);
+  timer.unref?.();
+  return {
+    stop: () => clearInterval(timer)
+  };
+}
+
 // src/commands/agent-bridge/harness/output-buffer.ts
 import { setTimeout as sleep2 } from "timers/promises";
 init_src();
@@ -41730,6 +41763,9 @@ var AgentBridgeOutputBuffer = class {
   uiMessagePartTracker = new UiMessagePartTracker();
   drainBlocked = false;
   drainPromise = null;
+  // Sequence of the most recent liveness beat, for the skip-while-pending
+  // gate in emitLivenessBeat.
+  pendingLivenessSeq = null;
   // Ack-retry-ladder exhausts per pending output sequence, for the poison
   // quarantine; entries clear when the sequence finally acks.
   ackExhaustsBySeq = /* @__PURE__ */ new Map();
@@ -41760,6 +41796,29 @@ var AgentBridgeOutputBuffer = class {
     await this.flushPendingDelta({ force: true });
     await this.drainPendingOutputs({ force: true });
   }
+  // Emits one runtime liveness beat through the same ordered, acked drain as
+  // content envelopes — deliberately, so a beat landing at the bridge proves
+  // the pipeline is healthy end to end. While a previous beat is still
+  // pending (stalled drain, retry ladder, reconnect) new beats are skipped
+  // rather than queued: an unhealthy pipeline must show up as beats
+  // *stopping*, and a backlog of parked beats replaying after recovery would
+  // stamp liveness for exactly the window the runtime was mute.
+  async emitLivenessBeat(context, intervalMs) {
+    if (this.pendingLivenessSeq !== null && this.pendingOutputs.has(this.pendingLivenessSeq)) {
+      return;
+    }
+    this.outputSeq += 1;
+    this.pendingLivenessSeq = this.outputSeq;
+    this.enqueueOutput(
+      buildLivenessOutputEnvelope({
+        context,
+        outputSeq: this.outputSeq,
+        intervalMs,
+        createdAt: now2()
+      })
+    );
+    await this.drainPendingOutputs();
+  }
   async emitUiMessageChunk(context, projection) {
     await this.flushPendingDelta();
     await this.emitLiveUiMessageChunk(context, projection.chunk);
@@ -42456,6 +42515,18 @@ function buildUiMessageChunkOutputEnvelope(input) {
     createdAt: input.createdAt
   });
 }
+function buildLivenessOutputEnvelope(input) {
+  const { context } = input;
+  return RuntimeBridgeOutputEnvelopeSchema.parse({
+    type: "runtime.liveness",
+    sessionId: context.sessionId,
+    runtimeId: context.runtimeId,
+    bridgeLeaseId: context.bridgeLeaseId,
+    outputSeq: input.outputSeq,
+    intervalMs: input.intervalMs,
+    createdAt: input.createdAt
+  });
+}
 function buildUiMessagePartOutputEnvelope(input) {
   const { context, snapshot } = input;
   return RuntimeBridgeOutputEnvelopeSchema.parse({
@@ -44141,11 +44212,16 @@ var ClaudeCodeCommandHandler = class {
   pendingQuestions = /* @__PURE__ */ new Map();
   outputBuffer;
   projector = new ClaudeCodeProjector();
+  livenessTicker = null;
   // -----------------------------------------------------------------------------
   // Lifecycle (public API)
   // -----------------------------------------------------------------------------
   setContext(nextContext) {
     this.context = RuntimeBridgeConnectedPayloadSchema.parse(nextContext);
+    this.livenessTicker ??= startRuntimeLivenessTicker({
+      emitBeat: () => this.emitLivenessBeat(),
+      writeOutput: this.input.writeOutput
+    });
   }
   async replayPendingOutputs() {
     await this.outputBuffer.replayPendingOutputs();
@@ -44154,6 +44230,8 @@ var ClaudeCodeCommandHandler = class {
     await this.ensureAgentSession().prepare();
   }
   shutdown() {
+    this.livenessTicker?.stop();
+    this.livenessTicker = null;
     this.agentSession?.close();
     this.agentSession = null;
     this.settlePendingQuestions("Runtime is shutting down");
@@ -44485,6 +44563,16 @@ var ClaudeCodeCommandHandler = class {
   // -----------------------------------------------------------------------------
   // SDK callbacks
   // -----------------------------------------------------------------------------
+  async emitLivenessBeat() {
+    const activeContext = this.context;
+    if (!activeContext) {
+      return;
+    }
+    await this.outputBuffer.emitLivenessBeat(
+      activeContext,
+      RUNTIME_LIVENESS_INTERVAL_MS
+    );
+  }
   async emitBridgeOutput(activeContext, projection) {
     try {
       await this.outputBuffer.emitProjection(activeContext, projection);
@@ -45951,12 +46039,17 @@ var CodexCommandHandler = class {
   pendingApprovals = /* @__PURE__ */ new Map();
   outputBuffer;
   projector = new CodexProjector();
+  livenessTicker = null;
   skipResumeForNextSession = false;
   // ---------------------------------------------------------------------------
   // Lifecycle (public API)
   // ---------------------------------------------------------------------------
   setContext(nextContext) {
     this.context = RuntimeBridgeConnectedPayloadSchema.parse(nextContext);
+    this.livenessTicker ??= startRuntimeLivenessTicker({
+      emitBeat: () => this.emitLivenessBeat(),
+      writeOutput: this.input.writeOutput
+    });
   }
   async replayPendingOutputs() {
     await this.outputBuffer.replayPendingOutputs();
@@ -45965,6 +46058,8 @@ var CodexCommandHandler = class {
     await this.ensureSession().prepare();
   }
   shutdown() {
+    this.livenessTicker?.stop();
+    this.livenessTicker = null;
     this.session?.close();
     this.session = null;
     this.pendingApprovals.clear();
@@ -46132,6 +46227,16 @@ var CodexCommandHandler = class {
       this.projector.projectSessionFailure(errorMessage3(error51))
     );
   }
+  async emitLivenessBeat() {
+    const activeContext = this.context;
+    if (!activeContext) {
+      return;
+    }
+    await this.outputBuffer.emitLivenessBeat(
+      activeContext,
+      RUNTIME_LIVENESS_INTERVAL_MS
+    );
+  }
   async emit(activeContext, projection) {
     try {
       await this.outputBuffer.emitProjection(activeContext, projection);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autohq/cli",
-  "version": "0.1.342",
+  "version": "0.1.343",
   "license": "SEE LICENSE IN README.md",
   "publishConfig": {
     "access": "public"