@playola-radio/slipstream 0.1.0 → 0.3.0

package/schemas/slipstream.capture.scope.v1.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.capture.scope.v1.json",
+  "title": "slipstream.capture.scope.v1",
+  "$comment": "Which paths capture follows from this point on. policy git: paths git would not merge (ignored and untracked) are not captured; status unavailable means git could not be asked, so affected observations were dropped and their prior state is unknown. slipstream_ignore active (git only): a root .slipstreamignore was frozen at capture start and excludes extra paths, including tracked ones git would keep. policy filesystem: the root is not a git work tree and every path is captured. 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.capture.scope.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",
+        "policy",
+        "status"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string"
+        }
+      },
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["policy", "status"],
+          "properties": {
+            "policy": { "const": "git" },
+            "status": { "const": "active" },
+            "slipstream_ignore": { "const": "active" }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["policy", "status"],
+          "properties": {
+            "policy": { "const": "git" },
+            "status": { "const": "unavailable" },
+            "slipstream_ignore": { "const": "active" }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["policy", "status"],
+          "properties": {
+            "policy": { "const": "filesystem" },
+            "status": { "const": "active" }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/slipstream.capture.stopped.v1.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.capture.stopped.v1.json",
+  "title": "slipstream.capture.stopped.v1",
+  "$comment": "The final record of an activation that stopped cleanly: observation stopped, accepted work drained, then this record was made durable before the log closed. It is never written after a lost lock or an unwritable store, so a missing stop together with no live owner heartbeat means not confirmed live, never still recording. detached: an explicit detach. archived: the workspace was archived. maintenance: stopped for garbage collection; capture resumes later on the same session. root-missing: the watched root was deleted or replaced. watcher-failed: the watcher subscription closed or could not be kept. The reason set is closed for v1. 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.capture.stopped.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",
+        "reason"
+      ],
+      "properties": {
+        "session_id": {
+          "type": "string"
+        },
+        "reason": {
+          "enum": [
+            "detached",
+            "archived",
+            "maintenance",
+            "root-missing",
+            "watcher-failed"
+          ]
+        }
+      }
+    }
+  }
+}

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

@@ -21,7 +21,17 @@
         "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 }
+        "attempted_at_ms": { "type": "integer", "minimum": 0 },
+        "target": {
+          "$comment": "The chat this attempt was handed to. Absent on attempts written before it was recorded; those went to the queued 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 }
+          }
+        }
       }
     }
   }

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

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.question.exchange_recorded.v1.json",
+  "title": "slipstream.question.exchange_recorded.v1",
+  "$comment": "A question asked at a code line together with the answer the client's own forked chat produced, recorded by the daemon without dispatch. The conversation ids are client-reported and unverified (reported_by is always client); they are never a binding and never authorship. 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.exchange_recorded.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", "text", "context", "answer_text", "recorded_at_ms", "conversation"],
+      "properties": {
+        "session_id": { "$ref": "#/$defs/uuid" },
+        "question_id": { "$ref": "#/$defs/uuid" },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "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" }
+          }
+        },
+        "answer_text": { "type": "string", "minLength": 1 },
+        "recorded_at_ms": { "type": "integer", "minimum": 0 },
+        "reply_to_question_id": { "$ref": "#/$defs/uuid" },
+        "conversation": {
+          "type": "object",
+          "required": ["harness", "parent_session_id", "fork_session_id", "reported_by"],
+          "properties": {
+            "harness": { "enum": ["claude-code", "codex"] },
+            "parent_session_id": { "type": "string", "minLength": 1, "maxLength": 256 },
+            "fork_session_id": { "type": "string", "minLength": 1, "maxLength": 256 },
+            "reported_by": { "const": "client" }
+          }
+        },
+        "relay": {
+          "$comment": "The change request this answer accepted; it counts as that relay's first send. chat_session_id is client-reported and unverified.",
+          "type": "object",
+          "required": ["relay_id", "chat_session_id"],
+          "properties": {
+            "relay_id": { "$ref": "#/$defs/uuid" },
+            "chat_session_id": { "type": "string", "minLength": 1, "maxLength": 256 }
+          }
+        }
+      }
+    }
+  },
+  "$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.question.relay_updated.v1.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://slipstream.dev/schemas/slipstream.question.relay_updated.v1.json",
+  "title": "slipstream.question.relay_updated.v1",
+  "$comment": "One later step of a change request sent from a recorded exchange, as the client reported it. Steps are recorded in arrival order with no order checks; a reader folds a relay's steps by the precedence in docs/ask-agent/contract.md. chat_session_id and report text are client-reported and unverified; never a binding and never authorship. 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.relay_updated.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", "relay_id", "request_id", "update", "recorded_at_ms"],
+      "properties": {
+        "session_id": { "$ref": "#/$defs/uuid" },
+        "question_id": { "$ref": "#/$defs/uuid" },
+        "relay_id": { "$ref": "#/$defs/uuid" },
+        "request_id": { "$ref": "#/$defs/uuid" },
+        "update": {
+          "oneOf": [
+            {
+              "$comment": "Send again: a new relay_id for the same question. A first send rides on the exchange's relay.",
+              "type": "object",
+              "required": ["kind", "chat_session_id"],
+              "properties": {
+                "kind": { "const": "sent" },
+                "chat_session_id": { "type": "string", "minLength": 1, "maxLength": 256 }
+              }
+            },
+            {
+              "type": "object",
+              "required": ["kind"],
+              "properties": { "kind": { "const": "picked_up" } }
+            },
+            {
+              "type": "object",
+              "required": ["kind"],
+              "properties": { "kind": { "const": "not_delivered" } }
+            },
+            {
+              "type": "object",
+              "required": ["kind", "outcome", "text"],
+              "properties": {
+                "kind": { "const": "reported" },
+                "outcome": { "enum": ["done", "not_done_yet"] },
+                "text": { "type": "string", "minLength": 1, "pattern": "\\S" }
+              }
+            }
+          ]
+        },
+        "recorded_at_ms": { "type": "integer", "minimum": 0 }
+      }
+    }
+  },
+  "$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

@@ -2,7 +2,7 @@
   "$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.",
+  "$comment": "Recorded at recovered_through_seq + 1 when capture of an existing session resumes (daemon restart or re-attach). It resets live state: there is no current task until a new task.started, questions queued before it are never claimable again, and any earlier agent.connection record is stale. capture_mode watch-only means this activation was started without a chat (attach --watch-only, or recovery of such a capture); absent means a chat attach started it, and watch-only is never inferred from absence. A later chat link never rewrites it. Self-contained; unknown fields permitted for forward compatibility.",
   "type": "object",
   "required": [
     "specversion",
@@ -63,6 +63,9 @@
         "resumed_at_ms": {
           "type": "integer",
           "minimum": 0
+        },
+        "capture_mode": {
+          "const": "watch-only"
         }
       }
     }

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

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://slipstream.dev/schemas/slipstream.session.started.v1.json",
   "title": "slipstream.session.started.v1",
-  "$comment": "CloudEvents 1.0 envelope. Self-contained by design: GET /v1/schemas/{type} returns everything needed to validate one event type. Unknown fields are permitted deliberately (forward compatibility is a contract).",
+  "$comment": "CloudEvents 1.0 envelope. Self-contained by design: GET /v1/schemas/{type} returns everything needed to validate one event type. capture_mode watch-only means this activation was started without a chat (attach --watch-only, or recovery of such a capture); absent means a chat attach started it, and watch-only is never inferred from absence. A later chat link never rewrites it. Unknown fields are permitted deliberately (forward compatibility is a contract).",
   "type": "object",
   "required": [
     "specversion",
@@ -62,6 +62,9 @@
         "started_at_ms": {
           "type": "integer",
           "minimum": 0
+        },
+        "capture_mode": {
+          "const": "watch-only"
         }
       }
     }

package/dist/transcript/runner.js

@@ -1,62 +0,0 @@
-import { createTranscriptWatcher } from "./watcher.js";
-export function createCoverageRunner(opts) {
-    const watchers = opts.harnesses.map((harness) => createTranscriptWatcher({
-        harness,
-        home: opts.homes[harness],
-        root: opts.root,
-        codexScanLimit: opts.codexScanLimit,
-        discoveryIO: opts.discoveryIO,
-        fileIO: opts.fileIO,
-        sink: opts.sink,
-        publish: opts.publish,
-    }));
-    const setTimer = opts.setTimer ??
-        ((ms, fn) => {
-            const t = setTimeout(fn, ms);
-            t.unref?.();
-            return t;
-        });
-    const clearTimer = opts.clearTimer ?? ((h) => clearTimeout(h));
-    let stopped = false;
-    let timer;
-    let inflight;
-    const tick = async () => {
-        for (const w of watchers) {
-            try {
-                await w.tick();
-            }
-            catch (err) {
-                opts.onError?.(err);
-            }
-        }
-    };
-    const schedule = () => {
-        if (stopped)
-            return;
-        timer = setTimer(opts.intervalMs, run);
-    };
-    const run = () => {
-        if (stopped)
-            return;
-        timer = undefined;
-        inflight = tick().finally(() => {
-            inflight = undefined;
-            schedule();
-        });
-    };
-    const start = () => {
-        if (stopped || timer !== undefined || inflight !== undefined)
-            return;
-        run();
-    };
-    const stop = async () => {
-        stopped = true;
-        if (timer !== undefined) {
-            clearTimer(timer);
-            timer = undefined;
-        }
-        if (inflight)
-            await inflight.catch(() => { });
-    };
-    return { tick, start, stop };
-}