@lelouchhe/webagent 0.8.0 → 0.10.0

package/lib/shared/task-reference.js

@@ -0,0 +1,20 @@
+/** Quote one task/path word for the shell-style task command grammar. */
+export function quoteShellWord(word) {
+    if (/[\s"'\\]/.test(word) || word === "") {
+        return `"${word.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+    }
+    return word;
+}
+/** Format a task title as a stable, shell-parseable @ reference. */
+export function formatTaskReference(title) {
+    return `@${quoteShellWord(title)}`;
+}
+/**
+ * Format tree path segments as the absolute `@`-prefixed path the input grammar
+ * and the UI completion use. The caller decides which segments are root-relative
+ * (see `Store.getTaskPath`); this only renders them, shell-quoting as needed so
+ * the result can be pasted straight into the input.
+ */
+export function formatTaskPath(segments) {
+    return `@/${segments.map(quoteShellWord).join("/")}`;
+}

package/lib/sse-manager.js

@@ -5,7 +5,7 @@ import { log } from "./log.js";
 const slog = log.scope("sse");
 /**
  * SSE heartbeat frame — a NAMED event so the frontend can hook
- * `es.addEventListener("heartbeat", ...)` and refresh its per-session
+ * `es.addEventListener("heartbeat", ...)` and refresh its per-task
  * visibility record on the server. Comment-line form (`: heartbeat\n\n`)
  * is silently discarded by EventSource — no `onmessage` fires — which is
  * why we use a named event instead. Riding the SSE connection's natural
@@ -41,7 +41,7 @@ export class SseManager {
     /**
      * Wire a label-map provider to enrich attachment uuid paths with
      * user-friendly labels at egress (CLAUDE.md "Attachment label
-     * egress rewrite"). Applied per-event-session inside `sendEvent`,
+     * egress rewrite"). Applied per-event-task inside `sendEvent`,
      * so both `broadcast()` and direct `sendEvent()` callers (e.g.
      * SSE Last-Event-ID replay) get enriched output. DB still stores
      * raw events.
@@ -95,7 +95,7 @@ export class SseManager {
         this.clients.set(client.id, client);
         slog.info("connected", {
             clientId: client.id,
-            sessionId: client.sessionId ?? "*",
+            taskId: client.taskId ?? "*",
             clients: this.clients.size,
         });
         client.res.on("close", () => {
@@ -134,7 +134,7 @@ export class SseManager {
             return;
         let outEvent = event;
         if (this.getLabelMap) {
-            const sid = event.sessionId;
+            const sid = event.taskId;
             if (sid) {
                 const map = this.getLabelMap(sid);
                 if (map.size > 0)
@@ -161,20 +161,20 @@ export class SseManager {
     }
     /**
      * Broadcast an event to all connected SSE clients.
-     * Global clients get all events. Per-session clients only get events for their session.
+     * Global clients get all events. Per-task clients only get events for their task.
      */
     broadcast(event) {
-        const sessionId = event.sessionId;
+        const taskId = event.taskId;
         const snapshot = [...this.clients.values()];
         for (const client of snapshot) {
             if (client.res.writableEnded)
                 continue;
-            if (client.sessionId && client.sessionId !== sessionId)
+            if (client.taskId && client.taskId !== taskId)
                 continue;
             this.sendEvent(client, event);
         }
     }
-    /** Broadcast global application state regardless of a client's session filter. */
+    /** Broadcast global application state regardless of a client's task filter. */
     broadcastGlobal(event) {
         const snapshot = [...this.clients.values()];
         for (const client of snapshot) {