@almadar/ui 5.64.0 → 5.67.0

package/dist/hooks/index.cjs

@@ -2821,6 +2821,99 @@ function useRenderInterpolation(options = {}) {
   }, []);
   return { onSnapshot, getInterpolated, startLoop };
 }
+var EMPTY_STATE = {
+  activities: [],
+  subagents: [],
+  coordinatorMessages: [],
+  status: "idle"
+};
+function upsertSubagent(subagents, id, patch) {
+  const idx = subagents.findIndex((s) => s.id === id);
+  if (idx === -1) {
+    const next = {
+      id,
+      name: patch.name ?? id,
+      role: patch.role ?? "",
+      status: patch.status ?? "running",
+      task: patch.task ?? "",
+      messages: []
+    };
+    if (patch.orbitalName !== void 0) next.orbitalName = patch.orbitalName;
+    if (patch.parentId !== void 0) next.parentId = patch.parentId;
+    if (patch.durationMs !== void 0) next.durationMs = patch.durationMs;
+    return [...subagents, next];
+  }
+  const merged = { ...subagents[idx] };
+  if (patch.name !== void 0) merged.name = patch.name;
+  if (patch.role !== void 0) merged.role = patch.role;
+  if (patch.orbitalName !== void 0) merged.orbitalName = patch.orbitalName;
+  if (patch.parentId !== void 0) merged.parentId = patch.parentId;
+  if (patch.status !== void 0) merged.status = patch.status;
+  if (patch.task !== void 0) merged.task = patch.task;
+  if (patch.durationMs !== void 0) merged.durationMs = patch.durationMs;
+  const out = subagents.slice();
+  out[idx] = merged;
+  return out;
+}
+function appendSubagentMessage(subagents, id, message) {
+  const idx = subagents.findIndex((s) => s.id === id);
+  if (idx === -1) return subagents;
+  const out = subagents.slice();
+  out[idx] = { ...out[idx], messages: [...out[idx].messages, message] };
+  return out;
+}
+function setCoordinatorMessage(messages, index, message) {
+  if (index < messages.length) {
+    const out = messages.slice();
+    out[index] = message;
+    return out;
+  }
+  return [...messages, message];
+}
+function reduce(state, update) {
+  switch (update.kind) {
+    case "activity":
+      return { ...state, activities: [...state.activities, update.activity] };
+    case "subagent-upsert":
+      return { ...state, subagents: upsertSubagent(state.subagents, update.id, update.subagent) };
+    case "subagent-message":
+      return { ...state, subagents: appendSubagentMessage(state.subagents, update.id, update.message) };
+    case "coordinator-message":
+      return {
+        ...state,
+        coordinatorMessages: setCoordinatorMessage(state.coordinatorMessages, update.index, update.message)
+      };
+    case "status":
+      return { ...state, status: update.status };
+    case "reset":
+      return EMPTY_STATE;
+  }
+}
+function traceReducer(state, action) {
+  if (action.type === "apply") return reduce(state, action.update);
+  return action.updates.reduce(reduce, state);
+}
+function useAgentTrace() {
+  const [state, dispatch] = react.useReducer(traceReducer, EMPTY_STATE);
+  const apply = react.useCallback((update) => {
+    dispatch({ type: "apply", update });
+  }, []);
+  const applyAll = react.useCallback((updates) => {
+    dispatch({ type: "applyAll", updates });
+  }, []);
+  const reset = react.useCallback(() => {
+    dispatch({ type: "apply", update: { kind: "reset" } });
+  }, []);
+  return {
+    activities: state.activities,
+    subagents: state.subagents,
+    coordinatorMessages: state.coordinatorMessages,
+    status: state.status,
+    apply,
+    applyAll,
+    reset
+  };
+}
 var API_BASE = typeof process !== "undefined" && process.env?.VITE_API_URL ? process.env.VITE_API_URL : "http://localhost:3000";
 function getUserId() {
   return localStorage.getItem("userId") || "anonymous";
@@ -2912,6 +3005,7 @@ exports.spawnEntity = spawnEntity;
 exports.updateEntity = updateEntity;
 exports.updateSingleton = updateSingleton;
 exports.useAgentChat = useAgentChat;
+exports.useAgentTrace = useAgentTrace;
 exports.useAuthContext = useAuthContext;
 exports.useCanvasGestures = useCanvasGestures;
 exports.useCompile = useCompile;

package/dist/hooks/index.d.ts

@@ -29,4 +29,5 @@ export { useTapReveal, type TapRevealOptions, type TapRevealResult, } from './us
 export { useDraggable, ALMADAR_DND_MIME, type DraggablePayload, type UseDraggableOptions, type UseDraggableResult, } from './useDraggable';
 export { useDropZone, type UseDropZoneOptions, type UseDropZoneResult, } from './useDropZone';
 export { useRenderInterpolation, type Positioned, type RenderInterpolationOptions, type RenderInterpolationHandle, } from './useRenderInterpolation';
+export { useAgentTrace, type UseAgentTraceResult, type AgentTraceState, type TraceStatus, type TraceUpdate, type SubagentUpsert, } from './useAgentTrace';
 export { useGitHubStatus, useConnectGitHub, useDisconnectGitHub, useGitHubRepos, useGitHubRepo, useGitHubBranches, type GitHubStatus, type GitHubRepo, } from './useGitHub';

package/dist/hooks/index.js

@@ -1,4 +1,4 @@
-import { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef, useSyncExternalStore } from 'react';
+import { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef, useSyncExternalStore, useReducer } from 'react';
 import { createLogger } from '@almadar/logger';
 import { EventBusContext, useTraitScope } from '@almadar/ui/providers';
 import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
@@ -2819,6 +2819,99 @@ function useRenderInterpolation(options = {}) {
   }, []);
   return { onSnapshot, getInterpolated, startLoop };
 }
+var EMPTY_STATE = {
+  activities: [],
+  subagents: [],
+  coordinatorMessages: [],
+  status: "idle"
+};
+function upsertSubagent(subagents, id, patch) {
+  const idx = subagents.findIndex((s) => s.id === id);
+  if (idx === -1) {
+    const next = {
+      id,
+      name: patch.name ?? id,
+      role: patch.role ?? "",
+      status: patch.status ?? "running",
+      task: patch.task ?? "",
+      messages: []
+    };
+    if (patch.orbitalName !== void 0) next.orbitalName = patch.orbitalName;
+    if (patch.parentId !== void 0) next.parentId = patch.parentId;
+    if (patch.durationMs !== void 0) next.durationMs = patch.durationMs;
+    return [...subagents, next];
+  }
+  const merged = { ...subagents[idx] };
+  if (patch.name !== void 0) merged.name = patch.name;
+  if (patch.role !== void 0) merged.role = patch.role;
+  if (patch.orbitalName !== void 0) merged.orbitalName = patch.orbitalName;
+  if (patch.parentId !== void 0) merged.parentId = patch.parentId;
+  if (patch.status !== void 0) merged.status = patch.status;
+  if (patch.task !== void 0) merged.task = patch.task;
+  if (patch.durationMs !== void 0) merged.durationMs = patch.durationMs;
+  const out = subagents.slice();
+  out[idx] = merged;
+  return out;
+}
+function appendSubagentMessage(subagents, id, message) {
+  const idx = subagents.findIndex((s) => s.id === id);
+  if (idx === -1) return subagents;
+  const out = subagents.slice();
+  out[idx] = { ...out[idx], messages: [...out[idx].messages, message] };
+  return out;
+}
+function setCoordinatorMessage(messages, index, message) {
+  if (index < messages.length) {
+    const out = messages.slice();
+    out[index] = message;
+    return out;
+  }
+  return [...messages, message];
+}
+function reduce(state, update) {
+  switch (update.kind) {
+    case "activity":
+      return { ...state, activities: [...state.activities, update.activity] };
+    case "subagent-upsert":
+      return { ...state, subagents: upsertSubagent(state.subagents, update.id, update.subagent) };
+    case "subagent-message":
+      return { ...state, subagents: appendSubagentMessage(state.subagents, update.id, update.message) };
+    case "coordinator-message":
+      return {
+        ...state,
+        coordinatorMessages: setCoordinatorMessage(state.coordinatorMessages, update.index, update.message)
+      };
+    case "status":
+      return { ...state, status: update.status };
+    case "reset":
+      return EMPTY_STATE;
+  }
+}
+function traceReducer(state, action) {
+  if (action.type === "apply") return reduce(state, action.update);
+  return action.updates.reduce(reduce, state);
+}
+function useAgentTrace() {
+  const [state, dispatch] = useReducer(traceReducer, EMPTY_STATE);
+  const apply = useCallback((update) => {
+    dispatch({ type: "apply", update });
+  }, []);
+  const applyAll = useCallback((updates) => {
+    dispatch({ type: "applyAll", updates });
+  }, []);
+  const reset = useCallback(() => {
+    dispatch({ type: "apply", update: { kind: "reset" } });
+  }, []);
+  return {
+    activities: state.activities,
+    subagents: state.subagents,
+    coordinatorMessages: state.coordinatorMessages,
+    status: state.status,
+    apply,
+    applyAll,
+    reset
+  };
+}
 var API_BASE = typeof process !== "undefined" && process.env?.VITE_API_URL ? process.env.VITE_API_URL : "http://localhost:3000";
 function getUserId() {
   return localStorage.getItem("userId") || "anonymous";
@@ -2895,4 +2988,4 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-export { ALMADAR_DND_MIME, DEFAULT_SLOTS, I18nProvider, clearEntities, createTranslate, getAllEntities, getByType, getEntity, getSingleton, parseQueryBinding, removeEntity, spawnEntity, updateEntity, updateSingleton, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEntities, useEntitiesByType, useEntity as useEntityById, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useInput, useLongPress, useOrbitalHistory, usePhysics, usePinchZoom, usePlayer, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSingletonEntity, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };
+export { ALMADAR_DND_MIME, DEFAULT_SLOTS, I18nProvider, clearEntities, createTranslate, getAllEntities, getByType, getEntity, getSingleton, parseQueryBinding, removeEntity, spawnEntity, updateEntity, updateSingleton, useAgentChat, useAgentTrace, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEntities, useEntitiesByType, useEntity as useEntityById, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useInput, useLongPress, useOrbitalHistory, usePhysics, usePinchZoom, usePlayer, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSingletonEntity, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };

package/dist/hooks/useAgentTrace.d.ts

@@ -0,0 +1,85 @@
+import type { TraceActivity, TraceSubagent, TraceSubagentMessage, TraceChatMessage } from '@almadar/core';
+/** Coarse run status surfaced by the trace UI (drives ChatBar's action button). */
+export type TraceStatus = 'idle' | 'running' | 'paused' | 'complete' | 'error';
+/** The accumulated view-model the trace components render. */
+export interface AgentTraceState {
+    activities: TraceActivity[];
+    subagents: TraceSubagent[];
+    coordinatorMessages: TraceChatMessage[];
+    status: TraceStatus;
+}
+/**
+ * A pre-mapped update the runner feeds in. Each variant is a view-model delta —
+ * no raw SSE/transport shapes. Subagents upsert by `id`; coordinator messages
+ * upsert by index (the runner owns ordering); activities append.
+ */
+export type TraceUpdate = 
+/** Append one already-mapped activity to the page-level stream. */
+{
+    kind: 'activity';
+    activity: TraceActivity;
+}
+/**
+ * Upsert a subagent by `id`. A partial patch merges into the existing record
+ * (status/duration/task changes); a full record inserts when `id` is new.
+ */
+ | {
+    kind: 'subagent-upsert';
+    id: string;
+    subagent: SubagentUpsert;
+}
+/** Append a progress message to a known subagent's running log. */
+ | {
+    kind: 'subagent-message';
+    id: string;
+    message: TraceSubagentMessage;
+}
+/**
+ * Set a coordinator message at `index`. The runner emits messages in order;
+ * a known index replaces (e.g. streaming content grew), a new index appends.
+ */
+ | {
+    kind: 'coordinator-message';
+    index: number;
+    message: TraceChatMessage;
+}
+/** Set the coarse run status. */
+ | {
+    kind: 'status';
+    status: TraceStatus;
+}
+/** Reset the whole view-model (new turn). */
+ | {
+    kind: 'reset';
+};
+/**
+ * A subagent upsert payload: every field optional except `name`/`role`/`task`
+ * are required only when the id is new. Partial patches merge into the existing
+ * record; that's why the fields are all optional here and the reducer fills
+ * defaults on first insert.
+ */
+export interface SubagentUpsert {
+    name?: string;
+    role?: string;
+    orbitalName?: string;
+    parentId?: string;
+    status?: TraceSubagent['status'];
+    task?: string;
+    durationMs?: number;
+}
+/** What the hook returns: the state plus an `apply` to feed it updates. */
+export interface UseAgentTraceResult extends AgentTraceState {
+    /** Apply one pre-mapped view-model update (from the runner). */
+    apply: (update: TraceUpdate) => void;
+    /** Apply a batch of updates in order (single render). */
+    applyAll: (updates: readonly TraceUpdate[]) => void;
+    /** Reset to the empty view-model. */
+    reset: () => void;
+}
+/**
+ * Accumulate agent-trace view-model from pre-mapped updates.
+ *
+ * The consumer maps SSE/runner events to `TraceUpdate`s upstream and calls
+ * `apply`/`applyAll`; this hook holds nothing but the accumulated render state.
+ */
+export declare function useAgentTrace(): UseAgentTraceResult;