sentinelayer-cli 0.12.5 → 0.13.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sentinelayer-cli",
-  "version": "0.12.5",
+  "version": "0.13.1",
   "description": "Scaffold Sentinelayer spec/prompt/guide artifacts with secure browser auth and token bootstrap.",
   "type": "module",
   "scripts": {

package/src/billing/llm-session-usage.js

@@ -31,6 +31,7 @@ export async function recordCliLlmSessionUsage({
   sourceCommand = "",
   provider = "",
   metadata = {},
+  syncRemote = true,
 } = {}) {
   const normalizedSessionId = normalizeString(sessionId);
   const normalizedAgentId = normalizeString(agentId);
@@ -80,7 +81,7 @@ export async function recordCliLlmSessionUsage({
           ...metadata,
         },
       },
-      { targetPath },
+      { targetPath, syncRemote },
     );
   } catch (error) {
     return {

package/src/commands/session.js

@@ -134,12 +134,12 @@ const SESSION_MESSAGE_ACTION_DESCRIPTIONS = Object.freeze([
   {
     type: "like",
     command: "sl session react <id> like --target-sequence <n>",
-    description: "Positive lightweight feedback.",
+    description: "Positive lightweight feedback. Use --target-action-id <uuid> to react to a threaded reply.",
   },
   {
     type: "dislike",
     command: "sl session react <id> dislike --target-sequence <n>",
-    description: "Negative lightweight feedback.",
+    description: "Negative lightweight feedback. Use --target-action-id <uuid> to react to a threaded reply.",
   },
   {
     type: "disregard",
@@ -190,6 +190,10 @@ function actionTargetCursor(action = {}) {
   return normalizeString(action.targetCursor ?? action.target_cursor);
 }
 
+function actionTargetActionId(action = {}) {
+  return normalizeString(action.targetActionId ?? action.target_action_id);
+}
+
 function actionActorId(action = {}) {
   return normalizeString(action.actorId ?? action.actor_id) || "unknown";
 }
@@ -201,7 +205,11 @@ function actionCreatedAt(action = {}) {
 function actionDisplayMessage(action = {}) {
   const actionType = normalizeString(action.actionType ?? action.action_type).toLowerCase();
   const targetSequence = actionTargetSequence(action);
-  const targetLabel = targetSequence ? `#${targetSequence}` : actionTargetCursor(action) || "target";
+  const targetActionId = actionTargetActionId(action);
+  const parentLabel = targetSequence ? `#${targetSequence}` : actionTargetCursor(action) || "";
+  const targetLabel = targetActionId
+    ? `action:${targetActionId}${parentLabel ? ` (${parentLabel})` : ""}`
+    : parentLabel || "target";
   const note = normalizeString(action.note);
   if (note) return `${actionType} ${targetLabel}: ${note}`;
   return `${actionType} ${targetLabel}`;
@@ -217,6 +225,7 @@ function buildSessionActionEvent(sessionId, action = {}) {
         actionType,
         targetSequenceId: actionTargetSequence(action),
         targetCursor: actionTargetCursor(action),
+        targetActionId: actionTargetActionId(action),
         actorId: actionActorId(action),
         note: normalizeString(action.note),
         createdAt: actionCreatedAt(action),
@@ -237,6 +246,7 @@ function buildSessionActionEvent(sessionId, action = {}) {
       actionType,
       targetSequenceId: actionTargetSequence(action),
       targetCursor: actionTargetCursor(action) || null,
+      targetActionId: actionTargetActionId(action) || null,
       note: normalizeString(action.note) || null,
       message: actionDisplayMessage(action),
       source: "session_action",
@@ -304,10 +314,15 @@ function defaultActionIdempotencyKey({
   actionType,
   targetSequenceId,
   targetCursor,
+  targetActionId,
   note,
   agentId,
 } = {}) {
-  const target = targetSequenceId ? `seq:${targetSequenceId}` : `cursor:${normalizeString(targetCursor)}`;
+  const target = normalizeString(targetActionId)
+    ? `action:${normalizeString(targetActionId)}`
+    : targetSequenceId
+      ? `seq:${targetSequenceId}`
+      : `cursor:${normalizeString(targetCursor)}`;
   const noteHash = note ? shortSha256(note) : "none";
   const actor = normalizeString(agentId) || "user";
   return `cli:${normalizeString(actionType).toLowerCase()}:${target}:${actor}:${noteHash}`;
@@ -1813,6 +1828,7 @@ export function registerSessionCommand(program) {
     commandName = "session action",
     targetSequenceId: targetSequenceIdOverride = null,
     targetCursor: targetCursorOverride = "",
+    targetActionId: targetActionIdOverride = "",
     note: noteOverride = "",
   } = {}) {
     const normalizedSessionId = normalizeString(sessionId);
@@ -1825,8 +1841,9 @@ export function registerSessionCommand(program) {
       targetSequenceIdOverride ||
       parseOptionalPositiveInteger(options.targetSequence, "target-sequence");
     const targetCursor = normalizeString(targetCursorOverride) || normalizeString(options.targetCursor);
-    if (!targetSequenceId && !targetCursor) {
-      throw new Error("Provide --target-sequence or --target-cursor.");
+    const targetActionId = normalizeString(targetActionIdOverride) || normalizeString(options.targetActionId);
+    if (!targetSequenceId && !targetCursor && !targetActionId) {
+      throw new Error("Provide --target-sequence, --target-cursor, or --target-action-id.");
     }
     await ensureLocalSessionForRemoteCommand(normalizedSessionId, { targetPath });
     const note = normalizeString(noteOverride) || normalizeString(options.note);
@@ -1837,6 +1854,7 @@ export function registerSessionCommand(program) {
         actionType: normalizedActionType,
         targetSequenceId,
         targetCursor,
+        targetActionId,
         note,
         agentId,
       });
@@ -1846,6 +1864,7 @@ export function registerSessionCommand(program) {
       targetPath,
       targetSequenceId,
       targetCursor,
+      targetActionId,
       note,
       metadata: {
         source: "cli",
@@ -1912,6 +1931,7 @@ export function registerSessionCommand(program) {
     )
     .option("--target-sequence <n>", "Target event sequence id")
     .option("--target-cursor <cursor>", "Target event cursor")
+    .option("--target-action-id <uuid>", "Target a threaded reply/action by action UUID")
     .option("--note <text>", "Optional action note or reply body")
     .option("--agent <id>", "Agent id for local idempotency metadata", "cli-user")
     .option("--idempotency-key <key>", "Explicit idempotency key")
@@ -1926,6 +1946,7 @@ export function registerSessionCommand(program) {
     .description("React to or acknowledge a target session event with ack, like, or dislike")
     .option("--target-sequence <n>", "Target event sequence id")
     .option("--target-cursor <cursor>", "Target event cursor")
+    .option("--target-action-id <uuid>", "Target a threaded reply/action by action UUID")
     .option("--agent <id>", "Agent id for local idempotency metadata", "cli-user")
     .option("--idempotency-key <key>", "Explicit idempotency key")
     .option("--path <path>", "Workspace path for the session", ".")

package/src/session/event-identity.js

@@ -55,6 +55,14 @@ export function sessionEventIdentityKeys(event = {}) {
   if (messageId) {
     keys.push(`message:${messageId}`);
   }
+  const actionId = typeof payload.actionId === "string"
+    ? payload.actionId.trim()
+    : typeof payload.action_id === "string"
+      ? payload.action_id.trim()
+      : "";
+  if (actionId) {
+    keys.push(`action:${actionId}`);
+  }
   const timestamp = timestampKey(event.ts, event.timestamp, event.at);
   const hasPayloadSignal = Object.keys(payload).length > 0;
   const hasFingerprintSignal =

package/src/session/sync.js

@@ -1245,6 +1245,7 @@ export async function listSessionMessageActions(
   {
     targetPath = process.cwd(),
     targetSequenceId = null,
+    targetActionId = "",
     limit = SESSION_ACTION_FETCH_LIMIT,
     timeoutMs = DEFAULT_SYNC_TIMEOUT_MS,
     forceCircuitProbe = false,
@@ -1294,6 +1295,10 @@ export async function listSessionMessageActions(
   if (Number.isFinite(normalizedTargetSequence) && normalizedTargetSequence > 0) {
     query.set("targetSequenceId", String(Math.floor(normalizedTargetSequence)));
   }
+  const normalizedTargetActionId = normalizeString(targetActionId);
+  if (normalizedTargetActionId) {
+    query.set("targetActionId", normalizedTargetActionId);
+  }
   query.set(
     "limit",
     String(Math.max(1, Math.min(SESSION_ACTION_FETCH_LIMIT, normalizePositiveInteger(limit, 200))))
@@ -1351,6 +1356,7 @@ export async function createSessionMessageAction(
     targetPath = process.cwd(),
     targetSequenceId = null,
     targetCursor = "",
+    targetActionId = "",
     note = "",
     metadata = {},
     idempotencyKey = "",
@@ -1402,6 +1408,10 @@ export async function createSessionMessageAction(
   if (normalizedTargetCursor) {
     body.targetCursor = normalizedTargetCursor;
   }
+  const normalizedTargetActionId = normalizeString(targetActionId);
+  if (normalizedTargetActionId) {
+    body.targetActionId = normalizedTargetActionId;
+  }
   const normalizedNote = normalizeString(note);
   if (normalizedNote) {
     body.note = normalizedNote;

package/src/session/transcript.js

@@ -155,7 +155,63 @@ function eventTimestamp(event) {
   return normalize(event?.ts || event?.timestamp);
 }
 
+function actionTargetLabel(payload = {}) {
+  const targetActionId = normalize(payload.targetActionId || payload.target_action_id);
+  const targetSequence = Number(payload.targetSequenceId || payload.target_sequence_id || 0);
+  const targetCursor = normalize(payload.targetCursor || payload.target_cursor);
+  const parent =
+    Number.isFinite(targetSequence) && targetSequence > 0
+      ? `#${Math.floor(targetSequence)}`
+      : targetCursor
+        ? `cursor ${targetCursor}`
+        : "";
+  if (targetActionId) {
+    return parent ? `reply action ${targetActionId} under ${parent}` : `reply action ${targetActionId}`;
+  }
+  return parent || "target";
+}
+
+function actionBody(event) {
+  const payload = event && typeof event.payload === "object" ? event.payload : {};
+  const kind = normalize(event?.event || event?.type);
+  const actionType = normalize(payload.actionType || payload.action_type || kind.replace(/^session_/, ""));
+  const target = actionTargetLabel(payload);
+  const actionId = normalize(payload.actionId || payload.action_id);
+  const note = normalize(payload.note);
+  const metadata = [];
+  if (actionId) metadata.push(`Action ID: \`${actionId}\``);
+  if (actionType) metadata.push(`Action: \`${actionType}\``);
+  if (kind === "session_reply") {
+    return [
+      `**Reply to:** \`${target}\``,
+      ...metadata,
+      note ? "" : null,
+      note || normalize(payload.message),
+    ].filter((line) => line !== null && line !== "").join("\n");
+  }
+  if (kind === "session_reaction") {
+    return [
+      `**Reaction:** \`${actionType || "reaction"}\` on \`${target}\``,
+      ...metadata,
+      note ? `Note: ${note}` : null,
+    ].filter(Boolean).join("\n");
+  }
+  if (kind === "session_action") {
+    return [
+      `**Session action:** \`${actionType || "action"}\` on \`${target}\``,
+      ...metadata,
+      note ? "" : null,
+      note,
+    ].filter((line) => line !== null && line !== "").join("\n");
+  }
+  return "";
+}
+
 function eventBody(event) {
+  const kind = normalize(event?.event || event?.type);
+  if (kind === "session_action" || kind === "session_reply" || kind === "session_reaction") {
+    return actionBody(event);
+  }
   const payload = event && typeof event.payload === "object" ? event.payload : {};
   // session_usage carries the response inside payload.response.text
   const responseText =