@ai-matrx/agents 0.23.0 → 0.24.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.24.0
+
+- **`resumeOrRejoin` follows the FINAL live-run contract** (aidream 0bd8c5cdc0, `services/runtime/FEATURE.md`): the 409 body's `rejoin_path` is followed verbatim (SEO collections answer `live_request_id: null` with `/seo/collections/{run_id}/rejoin`); chat's `resume_conflict` that names a live run (`live_request_id` / `rejoin_path`) REJOINS instead of retrying — only a bare `resume_conflict` is the `resume_conflict` outcome; a rejoin answering `409 live_stream_unavailable` follows `GET /runs/{run_id}/events/stream` when the body names a workflow `run_id` (new outcome `followed_workflow`, events to `onWorkflowEvent`, node_stream media frames included), else the durable lifecycle. New: `readLiveRunRejoin(error)` → `{ liveRequestId, rejoinPath, runId, code, body }`, `followWorkflowRunEvents`. Changed: outcomes carry `rejoin` (was `liveRequestId`); `onRejoin(rejoin)` receives the target. Guards: `matrx/rejoin.test.ts` (SEO path, chat live conflict, workflow SSE fallback — each proven red on a scratch mutant).
+- Consumer action: read `outcome.rejoin.liveRequestId` instead of `outcome.liveRequestId`; `onRejoin` now receives the target object.
+
 ## 0.23.0
 
 - **Resume never runs a live run twice — every client rejoins it** (`./matrx`). New `resumeOrRejoin(transport, resumeCall, { organizationId, onEnvelope, … })`: runs the feature's resume door and pipes its NDJSON into `onEnvelope`; on `409 run_in_progress` it follows `POST /runtime/operations/{live_request_id}/rejoin` into the SAME handler under the run's own organization; on `409 live_stream_unavailable` it follows the durable lifecycle (`followRuntimeOperationToEnd`) and says so (`kind: "followed"`); `409 resume_conflict` comes back as `kind: "resume_conflict"` (retry is host policy). Building blocks exported: `readLiveRunRequestId` (reads `live_request_id`, NEVER the envelope's own `request_id`), `readMatrxErrorCode`, `isResumeConflict`, `isLiveStreamUnavailable`, `runtimeOperationRejoinPath`, `openMatrxStream` (any NDJSON door by path), `withRunOrganization`. Guard: `matrx/rejoin.test.ts` (real envelopes with the `request_id` decoy; proven red on a mutant reading `request_id` and on one dropping the run org).