@playola-radio/slipstream 0.1.0

package/schemas/slipstream.file.baselined.v1.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.file.baselined.v1.json",
+  "title": "slipstream.file.baselined.v1",
+  "$comment": "One initial observed snapshot for a path at attach. Not an edit. Self-contained; unknown fields permitted for forward compatibility.",
+  "type": "object",
+  "required": [
+    "specversion",
+    "id",
+    "source",
+    "type",
+    "datacontenttype",
+    "seq",
+    "time",
+    "data"
+  ],
+  "properties": {
+    "specversion": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "source": {
+      "type": "string",
+      "pattern": "^urn:slipstream:session:"
+    },
+    "type": {
+      "const": "slipstream.file.baselined.v1"
+    },
+    "datacontenttype": {
+      "const": "application/json"
+    },
+    "seq": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "time": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "data": {
+      "type": "object",
+      "required": [
+        "session_id",
+        "path",
+        "snapshot"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "snapshot": {
+          "$ref": "#/$defs/snapshot"
+        }
+      }
+    }
+  },
+  "$defs": {
+    "snapshot": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": [
+            "kind",
+            "sha256",
+            "size"
+          ],
+          "properties": {
+            "kind": {
+              "const": "content"
+            },
+            "sha256": {
+              "type": "string",
+              "pattern": "^[0-9a-f]{64}$"
+            },
+            "size": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "const": "absent"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "kind",
+            "reason"
+          ],
+          "properties": {
+            "kind": {
+              "const": "unavailable"
+            },
+            "reason": {
+              "enum": [
+                "oversize",
+                "unreadable",
+                "unstable",
+                "io-error",
+                "baseline-unknown"
+              ]
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/slipstream.file.changed.v1.json

@@ -0,0 +1,179 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.file.changed.v1.json",
+  "title": "slipstream.file.changed.v1",
+  "$comment": "An observed transition at a path. `observation` distinguishes a live watcher observation from a restart/recovery reconciliation. `task_hint_id` is the immutable grouping hint (the committed task in effect when this change was ordered); `attribution` is revisable inference, never verified authorship. Self-contained; unknown fields permitted for forward compatibility.",
+  "type": "object",
+  "required": [
+    "specversion",
+    "id",
+    "source",
+    "type",
+    "datacontenttype",
+    "seq",
+    "time",
+    "data"
+  ],
+  "properties": {
+    "specversion": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "source": {
+      "type": "string",
+      "pattern": "^urn:slipstream:session:"
+    },
+    "type": {
+      "const": "slipstream.file.changed.v1"
+    },
+    "datacontenttype": {
+      "const": "application/json"
+    },
+    "seq": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "time": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "data": {
+      "type": "object",
+      "required": [
+        "session_id",
+        "path",
+        "before",
+        "after",
+        "observation",
+        "observed_at_ms"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "before": {
+          "$ref": "#/$defs/snapshot"
+        },
+        "after": {
+          "$ref": "#/$defs/snapshot"
+        },
+        "observation": {
+          "enum": [
+            "watcher",
+            "reconciliation"
+          ]
+        },
+        "coalesced": {
+          "type": "boolean"
+        },
+        "gap_ref": {
+          "type": "string",
+          "pattern": "^[1-9][0-9]*$"
+        },
+        "observed_at_ms": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "observed_interval_ms": {
+          "oneOf": [
+            {
+              "type": "object",
+              "required": ["start_ms", "end_ms"],
+              "properties": {
+                "start_ms": { "type": "integer", "minimum": 0 },
+                "end_ms": { "type": "integer", "minimum": 0 }
+              }
+            },
+            {
+              "type": "object",
+              "required": ["unavailable", "reason"],
+              "properties": {
+                "unavailable": { "const": true },
+                "reason": { "type": "string" }
+              }
+            }
+          ]
+        },
+        "task_hint_id": {
+          "type": "string"
+        },
+        "attribution": {
+          "type": "object",
+          "required": [
+            "status"
+          ],
+          "properties": {
+            "status": {
+              "const": "unknown"
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "snapshot": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": [
+            "kind",
+            "sha256",
+            "size"
+          ],
+          "properties": {
+            "kind": {
+              "const": "content"
+            },
+            "sha256": {
+              "type": "string",
+              "pattern": "^[0-9a-f]{64}$"
+            },
+            "size": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "const": "absent"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": [
+            "kind",
+            "reason"
+          ],
+          "properties": {
+            "kind": {
+              "const": "unavailable"
+            },
+            "reason": {
+              "enum": [
+                "oversize",
+                "unreadable",
+                "unstable",
+                "io-error",
+                "baseline-unknown"
+              ]
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/slipstream.harness.evidence.v1.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.harness.evidence.v1.json",
+  "title": "slipstream.harness.evidence.v1",
+  "$comment": "One durable, normalized harness-transcript record used to refine attribution. Never a filesystem-change event and never authorship. Records sharing an evidence_key describe one invocation (e.g. a start and an end); conflicting records under one key are all retained and disclosed, never merged. Self-contained; unknown fields permitted for forward compatibility.",
+  "type": "object",
+  "required": [
+    "specversion",
+    "id",
+    "source",
+    "type",
+    "datacontenttype",
+    "seq",
+    "time",
+    "data"
+  ],
+  "properties": {
+    "specversion": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "source": {
+      "type": "string",
+      "pattern": "^urn:slipstream:session:"
+    },
+    "type": {
+      "const": "slipstream.harness.evidence.v1"
+    },
+    "datacontenttype": {
+      "const": "application/json"
+    },
+    "seq": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "time": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "data": {
+      "type": "object",
+      "required": [
+        "session_id",
+        "evidence_key",
+        "adapter_version",
+        "tool_name",
+        "timestamp",
+        "file_scope"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string"
+        },
+        "evidence_key": {
+          "type": "object",
+          "required": [
+            "harness",
+            "harness_session_id",
+            "record_id"
+          ],
+          "properties": {
+            "harness": {
+              "enum": [
+                "claude-code",
+                "codex"
+              ]
+            },
+            "harness_session_id": {
+              "type": "string"
+            },
+            "record_id": {
+              "type": "string"
+            }
+          }
+        },
+        "adapter_version": {
+          "type": "string"
+        },
+        "tool_name": {
+          "type": "string"
+        },
+        "timestamp": {
+          "type": "object",
+          "required": [
+            "at_ms",
+            "basis"
+          ],
+          "properties": {
+            "at_ms": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "basis": {
+              "enum": [
+                "tool-start",
+                "tool-end",
+                "record-time"
+              ]
+            }
+          }
+        },
+        "file_scope": {
+          "oneOf": [
+            {
+              "type": "object",
+              "required": [
+                "kind",
+                "paths"
+              ],
+              "properties": {
+                "kind": {
+                  "const": "paths"
+                },
+                "paths": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            },
+            {
+              "type": "object",
+              "required": [
+                "kind",
+                "reason"
+              ],
+              "properties": {
+                "kind": {
+                  "const": "unknown"
+                },
+                "reason": {
+                  "type": "string"
+                }
+              }
+            }
+          ]
+        }
+      }
+    }
+  }
+}

package/schemas/slipstream.question.answered.v1.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.question.answered.v1.json",
+  "title": "slipstream.question.answered.v1",
+  "$comment": "An answer returned through the slipstream_answer_question tool by the harness session a question was dispatched to. It proves the call came through that session, not which agent in the session wrote it.",
+  "type": "object",
+  "required": ["specversion", "id", "source", "type", "datacontenttype", "seq", "time", "subject", "data"],
+  "properties": {
+    "specversion": { "const": "1.0" },
+    "id": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+    "source": { "type": "string", "pattern": "^urn:slipstream:session:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+    "type": { "const": "slipstream.question.answered.v1" },
+    "datacontenttype": { "const": "application/json" },
+    "seq": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+    "time": { "type": "string", "format": "date-time" },
+    "subject": { "type": "string", "pattern": "^question/[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+    "data": {
+      "type": "object",
+      "required": ["session_id", "question_id", "attempt_seq", "text", "answered_at_ms"],
+      "properties": {
+        "session_id": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "question_id": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "attempt_seq": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+        "text": { "type": "string", "minLength": 1, "maxLength": 16384 },
+        "answered_at_ms": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}

package/schemas/slipstream.question.dispatch_attempted.v1.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.question.dispatch_attempted.v1.json",
+  "title": "slipstream.question.dispatch_attempted.v1",
+  "$comment": "A durable delivery attempt committed before the hook response. It does not prove receipt or an answer.",
+  "type": "object",
+  "required": ["specversion", "id", "source", "type", "datacontenttype", "seq", "time", "subject", "data"],
+  "properties": {
+    "specversion": { "const": "1.0" },
+    "id": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+    "source": { "type": "string", "pattern": "^urn:slipstream:session:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+    "type": { "const": "slipstream.question.dispatch_attempted.v1" },
+    "datacontenttype": { "const": "application/json" },
+    "seq": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+    "time": { "type": "string", "format": "date-time" },
+    "subject": { "type": "string", "pattern": "^question/[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+    "data": {
+      "type": "object",
+      "required": ["session_id", "question_id", "queued_seq", "attempted_at_ms"],
+      "properties": {
+        "session_id": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "question_id": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "queued_seq": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+        "attempted_at_ms": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}

package/schemas/slipstream.question.queued.v1.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.question.queued.v1.json",
+  "title": "slipstream.question.queued.v1",
+  "$comment": "A durable queue admission. It acknowledges persistence, never target-harness or model receipt. Self-contained; unknown fields permitted for forward compatibility.",
+  "type": "object",
+  "required": ["specversion", "id", "source", "type", "datacontenttype", "seq", "time", "subject", "data"],
+  "properties": {
+    "specversion": { "const": "1.0" },
+    "id": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+    "source": { "type": "string", "pattern": "^urn:slipstream:session:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+    "type": { "const": "slipstream.question.queued.v1" },
+    "datacontenttype": { "const": "application/json" },
+    "seq": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+    "time": { "type": "string", "format": "date-time" },
+    "subject": { "type": "string", "pattern": "^question/[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+    "data": {
+      "type": "object",
+      "required": ["session_id", "question_id", "request_id", "target", "text", "context", "queued_at_ms", "expires_at_ms"],
+      "properties": {
+        "session_id": { "$ref": "#/$defs/uuid" },
+        "question_id": { "$ref": "#/$defs/uuid" },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "target": {
+          "type": "object",
+          "required": ["harness", "harness_session_id", "worktree"],
+          "properties": {
+            "harness": { "enum": ["claude-code", "codex"] },
+            "harness_session_id": { "type": "string", "minLength": 1 },
+            "worktree": { "type": "string", "minLength": 1 }
+          }
+        },
+        "text": { "type": "string", "minLength": 1 },
+        "context": {
+          "type": "object",
+          "required": ["change_seq", "path", "snapshot_sha256", "line_start", "line_end", "selected_text"],
+          "properties": {
+            "change_seq": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+            "path": { "type": "string", "minLength": 1 },
+            "snapshot_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+            "line_start": { "type": "integer", "minimum": 1 },
+            "line_end": { "type": "integer", "minimum": 1 },
+            "selected_text": { "type": "string" }
+          }
+        },
+        "queued_at_ms": { "type": "integer", "minimum": 0 },
+        "expires_at_ms": { "type": "integer", "minimum": 0 },
+        "reply_to_question_id": { "$ref": "#/$defs/uuid" }
+      }
+    }
+  },
+  "$defs": {
+    "uuid": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }
+  }
+}

package/schemas/slipstream.session.resumed.v1.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.session.resumed.v1.json",
+  "title": "slipstream.session.resumed.v1",
+  "$comment": "Recorded on restart at recovered_through_seq + 1. Self-contained; unknown fields permitted for forward compatibility.",
+  "type": "object",
+  "required": [
+    "specversion",
+    "id",
+    "source",
+    "type",
+    "datacontenttype",
+    "seq",
+    "time",
+    "data"
+  ],
+  "properties": {
+    "specversion": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "source": {
+      "type": "string",
+      "pattern": "^urn:slipstream:session:"
+    },
+    "type": {
+      "const": "slipstream.session.resumed.v1"
+    },
+    "datacontenttype": {
+      "const": "application/json"
+    },
+    "seq": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]*$"
+    },
+    "time": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "data": {
+      "type": "object",
+      "required": [
+        "session_id",
+        "recovered_through_seq",
+        "discarded_tail_bytes",
+        "resumed_at_ms"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string"
+        },
+        "recovered_through_seq": {
+          "type": "string",
+          "pattern": "^[0-9]+$"
+        },
+        "discarded_tail_bytes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "resumed_at_ms": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    }
+  }
+}