@ellipsis-dev/sdk 0.30.0 → 0.32.0

package/schema/lifecycle.schema.json

@@ -1,150 +1,8 @@
 {
   "$defs": {
-    "MessageDeliveredPayload": {
-      "additionalProperties": true,
-      "description": "message_delivered \u2014 a turn consumed the message.",
-      "properties": {
-        "message_id": {
-          "title": "Message Id",
-          "type": "string"
-        },
-        "turn_id": {
-          "title": "Turn Id",
-          "type": "string"
-        }
-      },
-      "required": [
-        "message_id",
-        "turn_id"
-      ],
-      "title": "MessageDeliveredPayload",
-      "type": "object"
-    },
-    "MessageReceivedPayload": {
+    "EnvironmentOutputPayload": {
       "additionalProperties": true,
-      "description": "message_received \u2014 a message landed in the session inbox. Puts \"what\narrived, from whom, when\" in the downloadable log; the session_messages\nrow is the internal delivery projection.",
-      "properties": {
-        "author": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Author"
-        },
-        "body": {
-          "title": "Body",
-          "type": "string"
-        },
-        "closes_session": {
-          "default": false,
-          "title": "Closes Session",
-          "type": "boolean"
-        },
-        "message_id": {
-          "title": "Message Id",
-          "type": "string"
-        },
-        "sender_attribution_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Sender Attribution Id"
-        },
-        "sender_attribution_type": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Sender Attribution Type"
-        }
-      },
-      "required": [
-        "message_id",
-        "body"
-      ],
-      "title": "MessageReceivedPayload",
-      "type": "object"
-    },
-    "MessageRequeuedPayload": {
-      "additionalProperties": true,
-      "description": "message_requeued \u2014 an errored turn returned the message to the inbox\n(at-least-once delivery; the next wake redelivers).",
-      "properties": {
-        "message_id": {
-          "title": "Message Id",
-          "type": "string"
-        },
-        "turn_id": {
-          "title": "Turn Id",
-          "type": "string"
-        }
-      },
-      "required": [
-        "message_id",
-        "turn_id"
-      ],
-      "title": "MessageRequeuedPayload",
-      "type": "object"
-    },
-    "OutboxCollectedPayload": {
-      "additionalProperties": true,
-      "description": "outbox_collected \u2014 the platform read a code_review session's\n/ellipsis/outbox/* at finalize (CODE_REVIEW_v3.md \u00a73). Carries both raw\nand parsed so the feed alone tells the whole delivery story; the\ncode_review_outbox table is the queryable projection of this record.",
-      "properties": {
-        "findings": {
-          "default": [],
-          "items": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "title": "Findings",
-          "type": "array"
-        },
-        "parse_errors": {
-          "default": [],
-          "items": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "title": "Parse Errors",
-          "type": "array"
-        },
-        "parser_version": {
-          "title": "Parser Version",
-          "type": "string"
-        },
-        "raw": {
-          "additionalProperties": {
-            "type": "string"
-          },
-          "default": {},
-          "title": "Raw",
-          "type": "object"
-        }
-      },
-      "required": [
-        "parser_version"
-      ],
-      "title": "OutboxCollectedPayload",
-      "type": "object"
-    },
-    "SandboxOutputPayload": {
-      "additionalProperties": true,
-      "description": "sandbox_output \u2014 one chunk of provisioning/lifecycle-script output.\nMany fire per execution; `chunk` rides the idempotency key. These records\nARE the durable copy (archived into the session log's S3 segments), under\na high per-session cap + truncation marker.",
+      "description": "environment_output: one chunk of output from preparing the environment,\nincluding the customer's own hooks. Many fire per turn; `chunk` orders them\nwithin a step.",
       "properties": {
         "chunk": {
           "title": "Chunk",
@@ -184,12 +42,12 @@
         "chunk",
         "lines"
       ],
-      "title": "SandboxOutputPayload",
+      "title": "EnvironmentOutputPayload",
       "type": "object"
     },
-    "SandboxPhasePayload": {
+    "EnvironmentPhasePayload": {
       "additionalProperties": true,
-      "description": "sandbox_phase \u2014 one transition of the provisioning state machine, so\nclients can narrate 'found a cached image' / 'cloning' / 'snapshotting'\nlive and locate failures. Phases are an OPEN vocabulary (SandboxPhase has\nthe known values); `detail` carries phase-specific extras additively\n(e.g. {\"cache_tier\": \"incremental\"} on image completion).",
+      "description": "environment_phase: one transition of environment preparation, so clients\ncan narrate progress live and locate failures. Phases are an OPEN\nvocabulary; `detail` carries phase-specific extras additively.",
       "properties": {
         "detail": {
           "anyOf": [
@@ -241,32 +99,24 @@
         "phase",
         "status"
       ],
-      "title": "SandboxPhasePayload",
+      "title": "EnvironmentPhasePayload",
       "type": "object"
     },
-    "SandboxReadyPayload": {
+    "EnvironmentReadyPayload": {
       "additionalProperties": true,
-      "description": "sandbox_ready \u2014 the box is up and the harness is about to launch: the\nsummary anchor closing the provisioning story. cache_tier/phase_timings\nduplicate the sandboxes-row columns purely for rendering convenience \u2014 the\nrow is the authority (\u00a72).",
+      "description": "environment_ready: the environment is prepared and the agent is about\nto start.",
       "properties": {
-        "cache_tier": {
+        "duration_ms": {
           "anyOf": [
             {
-              "type": "string"
+              "type": "integer"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "title": "Cache Tier"
-        },
-        "phase_timings": {
-          "additionalProperties": {
-            "type": "number"
-          },
-          "default": {},
-          "title": "Phase Timings",
-          "type": "object"
+          "title": "Duration Ms"
         },
         "repositories": {
           "items": {
@@ -279,96 +129,34 @@
       "required": [
         "repositories"
       ],
-      "title": "SandboxReadyPayload",
-      "type": "object"
-    },
-    "SandboxStartingPayload": {
-      "additionalProperties": true,
-      "description": "sandbox_starting \u2014 provisioning begins for this execution.",
-      "properties": {
-        "repositories": {
-          "items": {
-            "type": "string"
-          },
-          "title": "Repositories",
-          "type": "array"
-        }
-      },
-      "required": [
-        "repositories"
-      ],
-      "title": "SandboxStartingPayload",
+      "title": "EnvironmentReadyPayload",
       "type": "object"
     },
-    "SessionCancelledPayload": {
+    "MessageDeliveredPayload": {
       "additionalProperties": true,
-      "description": "session_cancelled \u2014 a preflight gate cancelled the session before any\nsandbox existed. Session-scoped (no execution).",
+      "description": "message_delivered: the agent started on the message.",
       "properties": {
-        "reason": {
-          "title": "Reason",
+        "message_id": {
+          "title": "Message Id",
           "type": "string"
-        }
-      },
-      "required": [
-        "reason"
-      ],
-      "title": "SessionCancelledPayload",
-      "type": "object"
-    },
-    "SessionClosedPayload": {
-      "additionalProperties": true,
-      "description": "session_closed \u2014 the conversation terminalized (closing event's final\nturn, or an ephemeral session's terminal).",
-      "properties": {},
-      "title": "SessionClosedPayload",
-      "type": "object"
-    },
-    "SessionIdlePayload": {
-      "additionalProperties": true,
-      "description": "session_idle \u2014 the warm loop ended and the durable conversation is\nparked; the next message wakes it.",
-      "properties": {},
-      "title": "SessionIdlePayload",
-      "type": "object"
-    },
-    "SessionResumedPayload": {
-      "additionalProperties": true,
-      "description": "session_resumed \u2014 a wake mounted the teardown snapshots and --resumed\nthe transcript. Its ABSENCE after a wake is the degraded-wake signal.",
-      "properties": {
-        "wake_index": {
-          "title": "Wake Index",
-          "type": "integer"
-        }
-      },
-      "required": [
-        "wake_index"
-      ],
-      "title": "SessionResumedPayload",
-      "type": "object"
-    },
-    "SessionRetryingPayload": {
-      "additionalProperties": true,
-      "description": "session_retrying \u2014 a transient infra failure before the agent acted\nhanded the session back for another attempt (bounded).",
-      "properties": {
-        "attempt": {
-          "title": "Attempt",
-          "type": "integer"
         },
-        "reason": {
-          "title": "Reason",
+        "turn_id": {
+          "title": "Turn Id",
           "type": "string"
         }
       },
       "required": [
-        "reason",
-        "attempt"
+        "message_id",
+        "turn_id"
       ],
-      "title": "SessionRetryingPayload",
+      "title": "MessageDeliveredPayload",
       "type": "object"
     },
-    "SessionScheduledPayload": {
+    "MessageReceivedPayload": {
       "additionalProperties": true,
-      "description": "session_scheduled \u2014 the session row exists and is queued for a worker.\nThe one session-scoped record emitted at creation (no execution yet).",
+      "description": "message_received: a message landed in the session inbox and its turn was\ncreated. `turn_id` is the turn that will answer it.",
       "properties": {
-        "config_commit_sha": {
+        "author": {
           "anyOf": [
             {
               "type": "string"
@@ -378,9 +166,22 @@
             }
           ],
           "default": null,
-          "title": "Config Commit Sha"
+          "title": "Author"
         },
-        "config_name": {
+        "body": {
+          "title": "Body",
+          "type": "string"
+        },
+        "closes_session": {
+          "default": false,
+          "title": "Closes Session",
+          "type": "boolean"
+        },
+        "message_id": {
+          "title": "Message Id",
+          "type": "string"
+        },
+        "sender_attribution_id": {
           "anyOf": [
             {
               "type": "string"
@@ -390,43 +191,95 @@
             }
           ],
           "default": null,
-          "title": "Config Name"
+          "title": "Sender Attribution Id"
         },
-        "source": {
-          "title": "Source",
-          "type": "string"
+        "sender_attribution_type": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Sender Attribution Type"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Turn Id"
         }
       },
       "required": [
-        "source"
+        "message_id",
+        "body"
       ],
-      "title": "SessionScheduledPayload",
+      "title": "MessageReceivedPayload",
       "type": "object"
     },
-    "SessionStartingPayload": {
+    "MessageRequeuedPayload": {
       "additionalProperties": true,
-      "description": "session_starting \u2014 a worker claimed the session and preflight passed.\nEmitted on EVERY claim; clients render wake_index > 0 as a wake.",
+      "description": "message_requeued: a turn was interrupted before answering, so the\nmessage goes back to the inbox with a new pending turn.",
       "properties": {
-        "attempt": {
-          "title": "Attempt",
-          "type": "integer"
+        "message_id": {
+          "title": "Message Id",
+          "type": "string"
         },
-        "wake_index": {
-          "title": "Wake Index",
-          "type": "integer"
+        "requeued_turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Requeued Turn Id"
+        },
+        "turn_id": {
+          "title": "Turn Id",
+          "type": "string"
         }
       },
       "required": [
-        "attempt",
-        "wake_index"
+        "message_id",
+        "turn_id"
       ],
-      "title": "SessionStartingPayload",
+      "title": "MessageRequeuedPayload",
+      "type": "object"
+    },
+    "SessionClosedPayload": {
+      "additionalProperties": true,
+      "description": "session_closed: the conversation closed permanently.",
+      "properties": {},
+      "title": "SessionClosedPayload",
       "type": "object"
     },
-    "TurnCompletedPayload": {
+    "TurnEndedPayload": {
       "additionalProperties": true,
-      "description": "turn_completed \u2014 the turn's result event closed it.",
+      "description": "turn_ended: the turn reached its final status. `status`, `reason`, and\n`detail` match the turn on the session object.",
       "properties": {
+        "detail": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Detail"
+        },
         "duration_ms": {
           "anyOf": [
             {
@@ -439,26 +292,22 @@
           "default": null,
           "title": "Duration Ms"
         },
-        "turn_id": {
-          "title": "Turn Id",
+        "reason": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Reason"
+        },
+        "status": {
+          "title": "Status",
           "type": "string"
         },
-        "turn_index": {
-          "title": "Turn Index",
-          "type": "integer"
-        }
-      },
-      "required": [
-        "turn_id",
-        "turn_index"
-      ],
-      "title": "TurnCompletedPayload",
-      "type": "object"
-    },
-    "TurnFailedPayload": {
-      "additionalProperties": true,
-      "description": "turn_failed \u2014 the turn terminalized without completing (its consumed\nmessages requeue).",
-      "properties": {
         "turn_id": {
           "title": "Turn Id",
           "type": "string"
@@ -470,14 +319,15 @@
       },
       "required": [
         "turn_id",
-        "turn_index"
+        "turn_index",
+        "status"
       ],
-      "title": "TurnFailedPayload",
+      "title": "TurnEndedPayload",
       "type": "object"
     },
     "TurnStartedPayload": {
       "additionalProperties": true,
-      "description": "turn_started \u2014 a message-exchange began.",
+      "description": "turn_started: the agent started on the turn's message.",
       "properties": {
         "turn_id": {
           "title": "Turn Id",
@@ -497,8 +347,17 @@
     }
   },
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "description": "Payloads of source='lifecycle' session records, keyed by record_type. Contract (SESSION_LIFECYCLE_EVENTS.md \u00a72): payload changes are additive-only; clients MUST ignore unknown record types and unknown payload fields, and MUST render unknown phase/step/status values generically.",
+  "description": "Payloads of source='lifecycle' session records, keyed by record_type. Contract: payload changes are additive-only; clients MUST ignore unknown record types and unknown payload fields, and MUST render unknown phase/step/status values generically.",
   "properties": {
+    "environment_output": {
+      "$ref": "#/$defs/EnvironmentOutputPayload"
+    },
+    "environment_phase": {
+      "$ref": "#/$defs/EnvironmentPhasePayload"
+    },
+    "environment_ready": {
+      "$ref": "#/$defs/EnvironmentReadyPayload"
+    },
     "message_delivered": {
       "$ref": "#/$defs/MessageDeliveredPayload"
     },
@@ -508,70 +367,25 @@
     "message_requeued": {
       "$ref": "#/$defs/MessageRequeuedPayload"
     },
-    "outbox_collected": {
-      "$ref": "#/$defs/OutboxCollectedPayload"
-    },
-    "sandbox_output": {
-      "$ref": "#/$defs/SandboxOutputPayload"
-    },
-    "sandbox_phase": {
-      "$ref": "#/$defs/SandboxPhasePayload"
-    },
-    "sandbox_ready": {
-      "$ref": "#/$defs/SandboxReadyPayload"
-    },
-    "sandbox_starting": {
-      "$ref": "#/$defs/SandboxStartingPayload"
-    },
-    "session_cancelled": {
-      "$ref": "#/$defs/SessionCancelledPayload"
-    },
     "session_closed": {
       "$ref": "#/$defs/SessionClosedPayload"
     },
-    "session_idle": {
-      "$ref": "#/$defs/SessionIdlePayload"
-    },
-    "session_resumed": {
-      "$ref": "#/$defs/SessionResumedPayload"
-    },
-    "session_retrying": {
-      "$ref": "#/$defs/SessionRetryingPayload"
-    },
-    "session_scheduled": {
-      "$ref": "#/$defs/SessionScheduledPayload"
-    },
-    "session_starting": {
-      "$ref": "#/$defs/SessionStartingPayload"
-    },
-    "turn_completed": {
-      "$ref": "#/$defs/TurnCompletedPayload"
-    },
-    "turn_failed": {
-      "$ref": "#/$defs/TurnFailedPayload"
+    "turn_ended": {
+      "$ref": "#/$defs/TurnEndedPayload"
     },
     "turn_started": {
       "$ref": "#/$defs/TurnStartedPayload"
     }
   },
   "required": [
+    "environment_output",
+    "environment_phase",
+    "environment_ready",
     "message_delivered",
     "message_received",
     "message_requeued",
-    "outbox_collected",
-    "sandbox_output",
-    "sandbox_phase",
-    "sandbox_ready",
-    "sandbox_starting",
-    "session_cancelled",
     "session_closed",
-    "session_idle",
-    "session_resumed",
-    "session_retrying",
-    "session_scheduled",
-    "session_starting",
-    "turn_completed",
-    "turn_failed",
+    "turn_ended",
     "turn_started"
   ],
   "title": "LifecyclePayloads",