@sanqianx/claude-ai-workbench 0.13.2 → 0.13.4

package/src/backend/lib/task-identity.js

@@ -1,104 +1,104 @@
-// Task identity - pure helpers for background-task scope and native-task refs.
-//
-// Canonical shapes (see packages/contracts/index.d.ts):
-//   scope:  { storeScope, contextId, parentSessionId }
-//   native: { kind: 'native-task', ...scope, ownerRunId, taskId }
-//
-// Every field is an already-resolved opaque string kept verbatim: identities
-// are never trimmed or rewritten (leading/trailing spaces are part of the id;
-// only all-whitespace values are invalid). Inputs are snapshotted - returned
-// objects share nothing with the caller input. No owner is derived here:
-// ownerRunId must come from the real parent tool-call relation, and volatile
-// state (runtimeEpoch, ports, PIDs, selected panel, turn numbers, timestamps)
-// never enters a persistent key.
-
-const SCOPE_FIELDS = ['storeScope', 'contextId', 'parentSessionId'];
-const NATIVE_TASK_KIND = 'native-task';
-const NATIVE_TASK_KEY_VERSION = 1;
-
-function isResolvedId(value) {
-  return typeof value === 'string' && value.trim() !== '';
-}
-
-/**
- * Snapshot the canonical session scope { storeScope, contextId, parentSessionId }.
- * Returns null when input is not an object, or any required field is missing,
- * not a string, or whitespace-only. Extra fields are ignored.
- */
-function createTaskScope(input) {
-  if (!input || typeof input !== 'object') return null;
-  const scope = {};
-  for (const field of SCOPE_FIELDS) {
-    const value = input[field];
-    if (!isResolvedId(value)) return null;
-    scope[field] = value;
-  }
-  return scope;
-}
-
-/**
- * Snapshot a native background task reference. Requires the explicit kind
- * 'native-task' (other kinds must not impersonate native tasks), a complete
- * scope, plus ownerRunId and taskId. ownerRunId is never defaulted from the
- * current turn or any other ambient state.
- */
-function createNativeTaskRef(input) {
-  if (!input || typeof input !== 'object') return null;
-  if (input.kind !== NATIVE_TASK_KIND) return null;
-  const scope = createTaskScope(input);
-  if (!scope) return null;
-  if (!isResolvedId(input.ownerRunId)) return null;
-  if (!isResolvedId(input.taskId)) return null;
-  return {
-    kind: NATIVE_TASK_KIND,
-    storeScope: scope.storeScope,
-    contextId: scope.contextId,
-    parentSessionId: scope.parentSessionId,
-    ownerRunId: input.ownerRunId,
-    taskId: input.taskId,
-  };
-}
-
-/**
- * Persistent key for a native task: an unambiguous JSON tuple with a fixed
- * version and fixed field order, so ids containing separators, quotes or
- * Unicode cannot collide or be rewritten. Returns null for anything that is
- * not a valid native-task reference. Only identity fields participate -
- * runtimeEpoch/ports/PIDs/selected panel/turn/time stay out of the key.
- */
-function nativeTaskKey(ref) {
-  const taskRef = createNativeTaskRef(ref);
-  if (!taskRef) return null;
-  return JSON.stringify([
-    'native-task',
-    NATIVE_TASK_KEY_VERSION,
-    taskRef.storeScope,
-    taskRef.contextId,
-    taskRef.parentSessionId,
-    taskRef.ownerRunId,
-    taskRef.taskId,
-  ]);
-}
-
-/**
- * Compare two objects by exactly the three canonical scope fields. Incomplete
- * or invalid scopes never compare equal; other fields (kind, taskId, ...) are
- * ignored, so two different tasks in the same scope still share a scope.
- * This is identity comparison only and carries no authorization meaning -
- * real access checks belong to the API layer.
- */
-function sameTaskScope(a, b) {
-  if (!a || typeof a !== 'object') return false;
-  if (!b || typeof b !== 'object') return false;
-  for (const field of SCOPE_FIELDS) {
-    if (!isResolvedId(a[field]) || a[field] !== b[field]) return false;
-  }
-  return true;
-}
-
-module.exports = {
-  createTaskScope,
-  createNativeTaskRef,
-  nativeTaskKey,
-  sameTaskScope,
-};
+// Task identity - pure helpers for background-task scope and native-task refs.
+//
+// Canonical shapes (see packages/contracts/index.d.ts):
+//   scope:  { storeScope, contextId, parentSessionId }
+//   native: { kind: 'native-task', ...scope, ownerRunId, taskId }
+//
+// Every field is an already-resolved opaque string kept verbatim: identities
+// are never trimmed or rewritten (leading/trailing spaces are part of the id;
+// only all-whitespace values are invalid). Inputs are snapshotted - returned
+// objects share nothing with the caller input. No owner is derived here:
+// ownerRunId must come from the real parent tool-call relation, and volatile
+// state (runtimeEpoch, ports, PIDs, selected panel, turn numbers, timestamps)
+// never enters a persistent key.
+
+const SCOPE_FIELDS = ['storeScope', 'contextId', 'parentSessionId'];
+const NATIVE_TASK_KIND = 'native-task';
+const NATIVE_TASK_KEY_VERSION = 1;
+
+function isResolvedId(value) {
+  return typeof value === 'string' && value.trim() !== '';
+}
+
+/**
+ * Snapshot the canonical session scope { storeScope, contextId, parentSessionId }.
+ * Returns null when input is not an object, or any required field is missing,
+ * not a string, or whitespace-only. Extra fields are ignored.
+ */
+function createTaskScope(input) {
+  if (!input || typeof input !== 'object') return null;
+  const scope = {};
+  for (const field of SCOPE_FIELDS) {
+    const value = input[field];
+    if (!isResolvedId(value)) return null;
+    scope[field] = value;
+  }
+  return scope;
+}
+
+/**
+ * Snapshot a native background task reference. Requires the explicit kind
+ * 'native-task' (other kinds must not impersonate native tasks), a complete
+ * scope, plus ownerRunId and taskId. ownerRunId is never defaulted from the
+ * current turn or any other ambient state.
+ */
+function createNativeTaskRef(input) {
+  if (!input || typeof input !== 'object') return null;
+  if (input.kind !== NATIVE_TASK_KIND) return null;
+  const scope = createTaskScope(input);
+  if (!scope) return null;
+  if (!isResolvedId(input.ownerRunId)) return null;
+  if (!isResolvedId(input.taskId)) return null;
+  return {
+    kind: NATIVE_TASK_KIND,
+    storeScope: scope.storeScope,
+    contextId: scope.contextId,
+    parentSessionId: scope.parentSessionId,
+    ownerRunId: input.ownerRunId,
+    taskId: input.taskId,
+  };
+}
+
+/**
+ * Persistent key for a native task: an unambiguous JSON tuple with a fixed
+ * version and fixed field order, so ids containing separators, quotes or
+ * Unicode cannot collide or be rewritten. Returns null for anything that is
+ * not a valid native-task reference. Only identity fields participate -
+ * runtimeEpoch/ports/PIDs/selected panel/turn/time stay out of the key.
+ */
+function nativeTaskKey(ref) {
+  const taskRef = createNativeTaskRef(ref);
+  if (!taskRef) return null;
+  return JSON.stringify([
+    'native-task',
+    NATIVE_TASK_KEY_VERSION,
+    taskRef.storeScope,
+    taskRef.contextId,
+    taskRef.parentSessionId,
+    taskRef.ownerRunId,
+    taskRef.taskId,
+  ]);
+}
+
+/**
+ * Compare two objects by exactly the three canonical scope fields. Incomplete
+ * or invalid scopes never compare equal; other fields (kind, taskId, ...) are
+ * ignored, so two different tasks in the same scope still share a scope.
+ * This is identity comparison only and carries no authorization meaning -
+ * real access checks belong to the API layer.
+ */
+function sameTaskScope(a, b) {
+  if (!a || typeof a !== 'object') return false;
+  if (!b || typeof b !== 'object') return false;
+  for (const field of SCOPE_FIELDS) {
+    if (!isResolvedId(a[field]) || a[field] !== b[field]) return false;
+  }
+  return true;
+}
+
+module.exports = {
+  createTaskScope,
+  createNativeTaskRef,
+  nativeTaskKey,
+  sameTaskScope,
+};

package/src/backend/lib/task-state-projection.js

@@ -1,58 +1,58 @@
-'use strict';
-
-// Pure projection of one claude/task-* fact onto the session's task index.
-// The raw normalized event is immutable input: it flows untouched into the
-// sequence/SSE/history stream, and only the indexed row is governed here:
-// - known-status whitelist (pending/running/completed/failed/stopped)
-// - the first terminal status is never revived or rewritten by later facts
-// - an unknown or missing status never overwrites an existing row's status
-// - a first-seen task without a usable status is explicitly 'unknown',
-//   never defaulted to running or completed
-// Rows are keyed by (sdkSessionId, taskId): a fact without real SDK
-// identity stays in the null bucket instead of borrowing the current
-// SDK session's identity.
-const KNOWN_TASK_STATUSES = new Set(['pending', 'running', 'completed', 'failed', 'stopped']);
-const TERMINAL_TASK_STATUSES = new Set(['completed', 'failed', 'stopped']);
-
-function normalizeSdkSessionId(value) {
-  return typeof value === 'string' && value !== '' ? value : null;
-}
-
-// Returns { index, task } where `task` is a freshly built row (never the
-// prior row, never the event) and `index` is -1 when the caller must insert.
-// Returns null when the fact carries no task id at all.
-function projectTaskStatus(existingTasks, event) {
-  if (!event || typeof event !== 'object') return null;
-  const taskId = typeof event.taskId === 'string' && event.taskId !== '' ? event.taskId : null;
-  if (!taskId) return null;
-  const tasks = Array.isArray(existingTasks) ? existingTasks : [];
-  const sdkSessionId = normalizeSdkSessionId(event.sdkSessionId);
-  const index = tasks.findIndex(task => task && task.taskId === taskId
-    && normalizeSdkSessionId(task.sdkSessionId) === sdkSessionId);
-  const prior = index < 0 ? null : tasks[index];
-  const incoming = typeof event.status === 'string' && KNOWN_TASK_STATUSES.has(event.status)
-    ? event.status : null;
-  let status;
-  let diagnostic = null;
-  if (!prior) {
-    if (incoming === null) {
-      status = 'unknown';
-      diagnostic = 'first-seen-unknown-status';
-    } else status = incoming;
-  } else if (incoming === null) {
-    status = prior.status;
-    diagnostic = 'unknown-status-kept';
-  } else if (TERMINAL_TASK_STATUSES.has(prior.status) && prior.status !== incoming) {
-    status = prior.status;
-    diagnostic = TERMINAL_TASK_STATUSES.has(incoming) ? 'first-terminal-kept' : 'terminal-not-revived';
-  } else {
-    status = incoming;
-  }
-  const task = { ...(prior || {}), ...event };
-  task.status = status;
-  if (diagnostic) task.diagnostic = diagnostic;
-  else delete task.diagnostic;
-  return { index, task };
-}
-
-module.exports = { projectTaskStatus, KNOWN_TASK_STATUSES, TERMINAL_TASK_STATUSES };
+'use strict';
+
+// Pure projection of one claude/task-* fact onto the session's task index.
+// The raw normalized event is immutable input: it flows untouched into the
+// sequence/SSE/history stream, and only the indexed row is governed here:
+// - known-status whitelist (pending/running/completed/failed/stopped)
+// - the first terminal status is never revived or rewritten by later facts
+// - an unknown or missing status never overwrites an existing row's status
+// - a first-seen task without a usable status is explicitly 'unknown',
+//   never defaulted to running or completed
+// Rows are keyed by (sdkSessionId, taskId): a fact without real SDK
+// identity stays in the null bucket instead of borrowing the current
+// SDK session's identity.
+const KNOWN_TASK_STATUSES = new Set(['pending', 'running', 'completed', 'failed', 'stopped']);
+const TERMINAL_TASK_STATUSES = new Set(['completed', 'failed', 'stopped']);
+
+function normalizeSdkSessionId(value) {
+  return typeof value === 'string' && value !== '' ? value : null;
+}
+
+// Returns { index, task } where `task` is a freshly built row (never the
+// prior row, never the event) and `index` is -1 when the caller must insert.
+// Returns null when the fact carries no task id at all.
+function projectTaskStatus(existingTasks, event) {
+  if (!event || typeof event !== 'object') return null;
+  const taskId = typeof event.taskId === 'string' && event.taskId !== '' ? event.taskId : null;
+  if (!taskId) return null;
+  const tasks = Array.isArray(existingTasks) ? existingTasks : [];
+  const sdkSessionId = normalizeSdkSessionId(event.sdkSessionId);
+  const index = tasks.findIndex(task => task && task.taskId === taskId
+    && normalizeSdkSessionId(task.sdkSessionId) === sdkSessionId);
+  const prior = index < 0 ? null : tasks[index];
+  const incoming = typeof event.status === 'string' && KNOWN_TASK_STATUSES.has(event.status)
+    ? event.status : null;
+  let status;
+  let diagnostic = null;
+  if (!prior) {
+    if (incoming === null) {
+      status = 'unknown';
+      diagnostic = 'first-seen-unknown-status';
+    } else status = incoming;
+  } else if (incoming === null) {
+    status = prior.status;
+    diagnostic = 'unknown-status-kept';
+  } else if (TERMINAL_TASK_STATUSES.has(prior.status) && prior.status !== incoming) {
+    status = prior.status;
+    diagnostic = TERMINAL_TASK_STATUSES.has(incoming) ? 'first-terminal-kept' : 'terminal-not-revived';
+  } else {
+    status = incoming;
+  }
+  const task = { ...(prior || {}), ...event };
+  task.status = status;
+  if (diagnostic) task.diagnostic = diagnostic;
+  else delete task.diagnostic;
+  return { index, task };
+}
+
+module.exports = { projectTaskStatus, KNOWN_TASK_STATUSES, TERMINAL_TASK_STATUSES };

package/src/index.js

@@ -1,7 +1,7 @@
-module.exports = {
-  contracts: require('../packages/contracts'),
-  client: require('../packages/client'),
-  core: require('../packages/core'),
-  server: require('../packages/server'),
-  backend: require('./backend')
-};
+module.exports = {
+  contracts: require('../packages/contracts'),
+  client: require('../packages/client'),
+  core: require('../packages/core'),
+  server: require('../packages/server'),
+  backend: require('./backend')
+};

package/src/sdk-wave-a.ts

@@ -1 +1 @@
-// new wave a
+// new wave a

package/src/sdk-wave-b.ts

@@ -1 +1 @@
-// new wave b
+// new wave b

package/src/sdk-wave-c.ts

@@ -1 +1 @@
-// new wave c
+// new wave c

package/src/sdk-wave-d.ts

@@ -1 +1 @@
-// new wave d
+// new wave d

package/src/sdk-wave-e.ts

@@ -1 +1 @@
-// new wave e
+// new wave e