@amaster.ai/employee-runtime-connector 0.1.1-beta.290 → 0.1.1-beta.292

package/README.md

@@ -210,6 +210,19 @@ An exact process-kill `EPERM` error emitted only after the first two layers have
 
 This isolation does not schedule a retry or a second business continuation. Command result delivery and the result outbox remain the sole idempotency boundary.
 
+## Live log delivery durability
+
+Executor process logs (stdout/stderr events, including full-transcript chat turns) are streamed to the Server as batches against `/ingest/logs/batch`. Every live log entry carries a per-command monotonically increasing `seq`; the Server dedupes on `(commandId, sourceSeq)`, so a retry after an ambiguous outcome (restart, timeout, 5xx) never duplicates canonical `heartbeat_run_events`.
+
+A batch whose delivery outcome is ambiguous is not dropped: it enters a bounded in-memory retry backlog that is retried on a timer and drains in source order, preserving `heartbeat_run_events` ordering. If the backlog is still undelivered when the executor turn ends, the remaining entries move into the durable result outbox and the command result is deferred until the log entries are delivered first; a sustained log-ingest outage bounded by `AMASTER_RESULT_OUTBOX_MAX_ATTEMPTS` drops the entries with a stderr diagnostic rather than holding the result hostage. HTTP 400 entries keep the existing bisect-to-invalid drop semantics.
+
+Tuning knobs (defaults are the production values):
+
+- `AMASTER_RUNTIME_LIVE_LOG_RETRY_BACKLOG_MAX_BYTES` (default 16 MiB): in-memory backlog bound; oldest batches are dropped with a diagnostic when exceeded.
+- `AMASTER_RUNTIME_LIVE_LOG_RETRY_INTERVAL_MS` (default 2000): background backlog retry cadence.
+- `AMASTER_RUNTIME_LIVE_LOG_FINAL_DRAIN_ATTEMPTS` (default 3) and `AMASTER_RUNTIME_LIVE_LOG_FINAL_DRAIN_TIMEOUT_MS` (default 5000): bounded final drain at the end of an executor turn.
+- `AMASTER_RUNTIME_DEFERRED_LOG_DRAIN_TIMEOUT_MS` (default 5000): per-batch timeout when delivering deferred entries before a command result or from the result outbox.
+
 ## Mutation attestation
 
 The daemon reports its connector contract, exact package/build, platform/architecture, and discovered executor versions on every heartbeat. The server compares those facts with `AMASTER_RUNTIME_RECOMMENDED_VERSION` and `AMASTER_RUNTIME_RECOMMENDED_BUILD_COMMIT`, persists a short-lived content-bound attestation, and correlates Runtime V2 commands to that proof.

package/dist/amaster-runtime-daemon/capability-registry.mjs

@@ -9,6 +9,7 @@ export const BUILD_SUPPORTED_CAPABILITIES = Object.freeze([
   "artifact_template_catalog_v1",
   "final_model_context_attestation_v1",
   "runtime_actions_v2",
+  "runtime_artifact_live_manifest_v1",
   "continue_task_v1",
   "run_exit_live_path_closure_v1",
   "model_call",
@@ -23,6 +24,10 @@ export const BUILD_SUPPORTED_CAPABILITIES = Object.freeze([
 ]);
 
 const DYNAMIC_READINESS = Object.freeze({
+  mirrorx_initialization_context_v1: {
+    reasonCode: "pi_executor_required",
+    ready: (input) => input.executors.some((executor) => executor.kind === "pi"),
+  },
   mirrorx_initialization_completion_v1: {
     reasonCode: "managed_linux_pi_required",
     ready: (input) => process.platform === "linux" && input.runnerKind === "cloud_managed"