summaryrefslogtreecommitdiffhomepage
path: root/specs/v2
diff options
context:
space:
mode:
Diffstat (limited to 'specs/v2')
-rw-r--r--specs/v2/session.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/specs/v2/session.md b/specs/v2/session.md
new file mode 100644
index 000000000..cae90ba7c
--- /dev/null
+++ b/specs/v2/session.md
@@ -0,0 +1,17 @@
+# Session API
+
+## Remove Dedicated `session.init` Route
+
+The dedicated `POST /session/:sessionID/init` endpoint exists only as a compatibility wrapper around the normal `/init` command flow.
+
+Current behavior:
+
+- the route calls `SessionPrompt.command(...)`
+- it sends `Command.Default.INIT`
+- it does not provide distinct session-core behavior beyond running the existing init command in an existing session
+
+V2 plan:
+
+- remove the dedicated `session.init` endpoint
+- rely on the normal `/init` command flow instead
+- avoid reintroducing `Session.initialize`-style special cases in the session service layer