Self-improving AI Employees for everyone
Python ai-agentsai-employeeai-employeesassistantautonomous-agentsco-employeescompanygrok-botinstinctloop-agentsmuseown-your-datapersonalself-hosted
/**
* The live "NOW" line: what a working employee is doing this moment, laid
* over the server's task text. Reads the same live state the editor
* canvas does (node statuses, the writeTodos cache), so it needs no extra
* requests:
*
* 1. an in-progress todo of the employee's todo list ("Checking tomorrow's
* appointments"),
* 2. otherwise, one of its watched nodes running ("Working on it..."),
* except the agent answering the owner in Talk: the conversation shows
* its own "Working…",
* 3. otherwise nothing, and the card shows the server's text ("Waiting for
* new WhatsApp messages").
*/
import { useQuery } from '@tanstack/react-query';
import { useCallback, useMemo } from 'react';
import type { NodeStatus } from '@/contexts/WebSocketContext';
import { todoQueryKey } from '@/lib/todoQuery';
import { useNodeStatusStore } from '@/stores/nodeStatusStore';
import type { EmployeeSummary } from './schemas';
const TODO_ID_MARK = ':writeTodos:';
interface TodoItem {
content?: unknown;
status?: unknown;
}
export function currentTodo(todos: unknown): string | null {
if (!Array.isArray(todos)) return null;
const active = (todos as TodoItem[]).find((todo) => todo?.status === 'in_progress');
const text = typeof active?.content === 'string' ? active.content.trim() : '';
return text || null;
}
/** The nodes whose work makes an employee "Working": the ones the summary
* watches, and the agent that answers the owner in Talk. */
export function workingNodeIds(employee: EmployeeSummary): readonly string[] {
const talkAgent = employee.talk.agent_node_id;
return talkAgent && !employee.watch_node_ids.includes(talkAgent)
? [...employee.watch_node_ids, talkAgent]
: employee.watch_node_ids;
}
/** True while one of these nodes is executing in this workflow's statuses. */
export function isAnswering(statuses: Record<string, NodeStatus> | undefined, nodeIds: readonly string[]): boolean {
return Boolean(statuses) && nodeIds.some((id) => statuses?.[id]?.status === 'executing');
}
/** Whether the employee is answering or doing a job right now: the pill says
* "Working" only then, "Ready" while they run idle (data/presentation). */
export function useAnswering(employee: EmployeeSummary): boolean {
const ids = useMemo(() => workingNodeIds(employee), [employee]);
return useNodeStatusStore(
useCallback((state) => isAnswering(state.allStatuses[employee.workflow_id], ids), [employee.workflow_id, ids]),
);
}
/** How many running employees are answering or working right now. */
export function useAnsweringCount(employees: readonly EmployeeSummary[] | undefined): number {
const running = useMemo(
() => (employees ?? []).filter((e) => e.status === 'working').map((e) => ({ workflowId: e.workflow_id, ids: workingNodeIds(e) })),
[employees],
);
return useNodeStatusStore(
useCallback((state) => running.filter((e) => isAnswering(state.allStatuses[e.workflowId], e.ids)).length, [running]),
);
}
export function useLiveTask(employee: EmployeeSummary): { label: 'Now'; text: string } | null {
const todoNodeId = employee.watch_node_ids.find((id) => id.includes(TODO_ID_MARK)) ?? null;
const { data: todos } = useQuery<unknown>({
queryKey: todoQueryKey(employee.workflow_id, todoNodeId ?? ''),
queryFn: () => [],
enabled: false,
staleTime: Infinity,
});
const watchKey = employee.watch_node_ids.join('|');
const talkAgent = employee.talk.agent_node_id;
const running = useNodeStatusStore(
useCallback(
(state) => {
const statuses = state.allStatuses[employee.workflow_id];
if (!statuses) return false;
return watchKey.split('|').some((id) => id && id !== talkAgent && statuses[id]?.status === 'executing');
},
[employee.workflow_id, watchKey, talkAgent],
),
);
// While the agent waits for the owner in the browser its node is still
// executing; the server's "Needs you…" task is the one to show.
if (employee.status !== 'working' || employee.browser_request) return null;
const todo = todoNodeId ? currentTodo(todos) : null;
if (todo) return { label: 'Now', text: todo };
if (running) return { label: 'Now', text: 'Working on it…' };
return null;
}