@adecore/agents-react 0.39.0 → 0.40.0

package/src/chat/logic/workflow.ts

@@ -21,9 +21,11 @@ export function workflowAgentState(agent: ChatWorkflowAgent, workflowRunning: bo
     if (agent.status !== 'running') {
         return agent.status;
     }
+
     if (!workflowRunning) {
         return 'stopped';
     }
+
     return agent.startedAt === null ? 'waiting' : 'running';
 }
 
@@ -35,15 +37,21 @@ export function workflowPhases(workflow: ChatWorkflow, workflowRunning: boolean)
     const known = new Map(workflow.phases.map((phase) => [phase.index, phase]));
     const loose: WorkflowAgentView[] = [];
     const byPhase = new Map<number, WorkflowAgentView[]>();
+
     for (const agent of workflow.agents) {
         const view = { agent, state: workflowAgentState(agent, workflowRunning) };
+
         if (agent.phaseIndex === null || !known.has(agent.phaseIndex)) {
             loose.push(view);
+
             continue;
         }
+
         byPhase.set(agent.phaseIndex, [...(byPhase.get(agent.phaseIndex) ?? []), view]);
     }
+
     const phases = workflow.phases.map((phase) => ({ key: `phase-${phase.index}`, title: phase.title, agents: byPhase.get(phase.index) ?? [] }));
+
     return loose.length > 0 ? [{ key: 'loose', title: null, agents: loose }, ...phases] : phases;
 }
 
@@ -70,16 +78,18 @@ export interface WorkflowAgentPreview {
 
 /* The CLI's previews start with a markdown heading as often as not, which says nothing on one line. */
 function firstLine(text: string | undefined): string | null {
-    const line = text
-        ?.split('\n')
-        .map((part) => part.replace(/^#+\s*/, '').trim())
-        .find((part) => part !== '');
-    return line === undefined ? null : line;
+    return (
+        text
+            ?.split('\n')
+            .map((part) => part.replace(/^#+\s*/, '').trim())
+            .find((part) => part !== '') ?? null
+    );
 }
 
 /* The second line of an agent: what it does while at work, what it answered once it stopped, what it was asked before. */
 export function workflowAgentPreview(view: WorkflowAgentView): WorkflowAgentPreview {
     const { agent } = view;
+
     switch (view.state) {
         case 'running':
             return agent.lastTool === null
@@ -99,10 +109,12 @@ export type WorkflowCounts = Record<WorkflowAgentState, number> & { total: numbe
 
 export function workflowCounts(phases: WorkflowPhaseView[]): WorkflowCounts {
     const counts: WorkflowCounts = { total: 0, running: 0, waiting: 0, stopped: 0, done: 0, failed: 0 };
+
     for (const view of phases.flatMap((phase) => phase.agents)) {
         counts.total += 1;
         counts[view.state] += 1;
     }
+
     return counts;
 }
 
@@ -112,22 +124,28 @@ const DESCRIPTION = /\bdescription\s*:\s*(['"`])((?:\\.|(?!\1)[^\\])*)\1/;
 /* The literal from its opening brace to the one that closes it, skipping braces inside strings. */
 function metaLiteral(script: string): string | null {
     const start = META_START.exec(script);
+
     if (start === null) {
         return null;
     }
+
     const from = start.index + start[0].length - 1;
     let depth = 0;
     let quote: string | null = null;
+
     for (let i = from; i < script.length; i++) {
         const char = script[i]!;
+
         if (quote !== null) {
             if (char === '\\') {
                 i++;
             } else if (char === quote) {
                 quote = null;
             }
+
             continue;
         }
+
         if (char === "'" || char === '"' || char === '`') {
             quote = char;
         } else if (char === '{') {
@@ -136,6 +154,7 @@ function metaLiteral(script: string): string | null {
             return script.slice(from, i + 1);
         }
     }
+
     return null;
 }
 
@@ -143,6 +162,6 @@ function metaLiteral(script: string): string | null {
 export function workflowDescription(input: unknown): string | null {
     const script = typeof input === 'object' && input !== null && 'script' in input ? input.script : undefined;
     const meta = typeof script === 'string' ? metaLiteral(script) : null;
-    const found = meta === null ? undefined : DESCRIPTION.exec(meta)?.[2]?.replace(/\\(.)/g, '$1').trim();
-    return found ? found : null;
+
+    return (meta === null ? undefined : DESCRIPTION.exec(meta)?.[2]?.replace(/\\(.)/g, '$1').trim()) || null;
 }

package/src/chat/mentions.ts

@@ -12,12 +12,14 @@ export function carriesMentions(types: readonly string[]): boolean {
 
 export function droppedMentions(data: Pick<DataTransfer, 'getData'>): string[] {
     const text = data.getData(MENTION_DRAG_TYPE) || data.getData(LEGACY_MENTION_DRAG_TYPE);
+
     return text.trim() === '' ? [] : text.trim().split(/\s+/);
 }
 
 export function writeMentionDrag(data: Pick<DataTransfer, 'setData'>, paths: readonly string[], legacy = true): void {
     const text = paths.join(' ');
     data.setData(MENTION_DRAG_TYPE, text);
+
     if (legacy) {
         data.setData(LEGACY_MENTION_DRAG_TYPE, text);
     }
@@ -36,6 +38,7 @@ export interface ClipboardChips {
 /* The chips among `segments`, without doubles, for the copy of `text`. */
 export function clipboardChipsOf(text: string, segments: readonly ChipSegment[]): ClipboardChips {
     const chips: ClipboardChips = { text, mentions: [], skills: [], references: [] };
+
     for (const segment of segments) {
         if (segment.kind === 'mention' && !chips.mentions.includes(segment.path)) {
             chips.mentions.push(segment.path);
@@ -45,6 +48,7 @@ export function clipboardChipsOf(text: string, segments: readonly ChipSegment[])
             chips.references.push({ id: segment.id, name: segment.name });
         }
     }
+
     return chips;
 }
 
@@ -64,28 +68,36 @@ const isStrings = (value: unknown): value is string[] => Array.isArray(value) &&
 /* The chips of a paste, or null when it has none or its plain text is no longer the text they were copied with. */
 export function readClipboardChips(data: Pick<DataTransfer, 'getData'>): ClipboardChips | null {
     const raw = data.getData(CHIPS_CLIPBOARD_TYPE);
+
     if (raw === '') {
         return null;
     }
+
     let parsed: unknown;
+
     try {
         parsed = JSON.parse(raw);
     } catch {
         return null;
     }
+
     if (typeof parsed !== 'object' || parsed === null) {
         return null;
     }
+
     const { text, mentions, skills, references } = parsed as Record<string, unknown>;
+
     const tokens = Array.isArray(references)
         ? references.filter(
               (token): token is ReferenceToken =>
                   typeof token === 'object' && token !== null && typeof token.id === 'string' && typeof token.name === 'string' && token.name !== ''
           )
         : [];
+
     if (typeof text !== 'string' || lines(text) !== lines(data.getData('text/plain')) || !isStrings(mentions) || !isStrings(skills)) {
         return null;
     }
+
     return { text: lines(text), mentions, skills, references: tokens.map(({ id, name }) => ({ id, name })) };
 }
 
@@ -129,16 +141,21 @@ const PATH_GOES_ON = /[.:]$/;
 function findQuery(text: string, caret: number, sigil: string): MentionQuery | null {
     const before = text.slice(0, caret);
     const at = before.lastIndexOf(sigil);
+
     if (at < 0 || !isBoundary(before[at - 1])) {
         return null;
     }
+
     const query = before.slice(at + 1);
+
     if (/\s/.test(query) || !isBoundary(text[caret])) {
         return null;
     }
+
     if (query !== '' && isTokenEnd(query.at(-1)) && !(sigil === '@' && PATH_GOES_ON.test(query))) {
         return null;
     }
+
     return { start: at, query };
 }
 
@@ -154,6 +171,7 @@ export function findMentionQuery(text: string, caret: number): MentionQuery | nu
 /* The `$word` the caret sits in. The name has to start with a letter, so `$20` and `$1e6` stay text. */
 export function findSkillQuery(text: string, caret: number): MentionQuery | null {
     const found = findQuery(text, caret, '$');
+
     return found === null || (found.query !== '' && !/^[A-Za-z]/.test(found.query)) ? null : found;
 }
 
@@ -163,6 +181,7 @@ export function findSkillQuery(text: string, caret: number): MentionQuery | null
  */
 export function findReferenceQuery(text: string, caret: number): MentionQuery | null {
     const found = findQuery(text, caret, '#');
+
     return found === null || !/^\p{L}/u.test(found.query) ? null : found;
 }
 
@@ -170,6 +189,7 @@ export function findReferenceQuery(text: string, caret: number): MentionQuery |
 export function insertToken(text: string, query: MentionQuery, sigil: string, value: string): { text: string; caret: number } {
     const end = query.start + 1 + query.query.length;
     const token = `${sigil}${value} `;
+
     return { text: `${text.slice(0, query.start)}${token}${text.slice(end)}`, caret: query.start + token.length };
 }
 
@@ -198,29 +218,36 @@ export function mentionPick(index: number, search: MentionSearch, query: string)
     if (search.query !== query) {
         return null;
     }
+
     return search.files[index] ?? search.files[0] ?? null;
 }
 
 function findToken(text: string, sigil: string, value: string, from: number): number {
     const token = `${sigil}${value}`;
     let index = text.indexOf(token, from);
+
     while (index >= 0) {
         if (isBoundary(text[index - 1]) && isTokenEnd(text[index + token.length])) {
             return index;
         }
+
         index = text.indexOf(token, index + 1);
     }
+
     return -1;
 }
 
 function present(text: string, sigil: string, chosen: string[]): string[] {
     const found: Array<{ index: number; value: string }> = [];
+
     for (const value of new Set(chosen)) {
         const index = findToken(text, sigil, value, 0);
+
         if (index >= 0) {
             found.push({ index, value });
         }
     }
+
     return found.sort((a, b) => a.index - b.index).map((entry) => entry.value);
 }
 
@@ -237,6 +264,7 @@ export function presentSkills(text: string, chosen: string[]): string[] {
 /* The ids among `ids` whose `#name` still sits in the text as a whole token, in text order and without doubles. */
 export function presentReferences(text: string, ids: readonly string[], tokens: readonly ReferenceToken[]): string[] {
     const wanted = new Set(ids);
+
     return chipRanges(text, [], [], [], tokens)
         .map((range) => range.value)
         .filter((id, index, found) => wanted.has(id) && found.indexOf(id) === index);
@@ -247,12 +275,15 @@ export function chipText(segment: ChipSegment): string {
     if (segment.kind === 'mention') {
         return `@${segment.path}`;
     }
+
     if (segment.kind === 'skill') {
         return `$${segment.name}`;
     }
+
     if (segment.kind === 'reference') {
         return `#${segment.name}`;
     }
+
     return segment.text;
 }
 
@@ -262,9 +293,11 @@ export function chipText(segment: ChipSegment): string {
  */
 export function pastedMentions(text: string): string[] {
     const tokens = text.trim().split(/\s+/);
+
     if (tokens.some((token) => !/^@[^\s@]+$/.test(token))) {
         return [];
     }
+
     return [...new Set(tokens.map((token) => token.slice(1)))];
 }
 
@@ -295,27 +328,36 @@ export function chipRanges(
         ...[...new Set(skills)].map((value) => ({ sigil: '$', kind: 'skill' as const, spelled: value, value })),
         ...references.filter((token) => token.name !== '').map((token) => ({ sigil: '#', kind: 'reference' as const, spelled: token.name, value: token.id }))
     ].sort((a, b) => b.spelled.length - a.spelled.length);
+
     const allowed = (from: number, to: number): boolean => !excluded.some((range) => from < range.to && to > range.from);
+
     const ranges: ChipRange[] = [];
     let cursor = 0;
+
     while (cursor < text.length) {
         let best: ChipRange | null = null;
+
         for (const token of tokens) {
             const length = token.spelled.length + 1;
             let index = findToken(text, token.sigil, token.spelled, cursor);
+
             while (index >= 0 && !allowed(index, index + length)) {
                 index = findToken(text, token.sigil, token.spelled, index + 1);
             }
+
             if (index >= 0 && (best === null || index < best.from)) {
                 best = { from: index, to: index + length, kind: token.kind, value: token.value };
             }
         }
+
         if (best === null) {
             break;
         }
+
         ranges.push(best);
         cursor = best.to;
     }
+
     return ranges;
 }
 
@@ -323,9 +365,11 @@ function segmentOf(text: string, range: ChipRange): ChipSegment {
     if (range.kind === 'mention') {
         return { kind: 'mention', path: range.value };
     }
+
     if (range.kind === 'skill') {
         return { kind: 'skill', name: range.value };
     }
+
     return { kind: 'reference', id: range.value, name: text.slice(range.from + 1, range.to) };
 }
 
@@ -349,29 +393,37 @@ export function namedReferenceRanges(
     excluded: readonly TextRange[] = []
 ): ChipRange[] {
     const byName = new Map<string, string[]>();
+
     for (const item of items) {
         if (item.name !== '') {
             byName.set(item.name, [...(byName.get(item.name) ?? []), item.id]);
         }
     }
+
     const names = [...byName.keys()].sort((a, b) => b.length - a.length);
     const preferred = new Set(referenced);
     const ranges: ChipRange[] = [];
     let index = text.indexOf('#');
+
     while (index >= 0) {
         const from = index;
+
         const name =
             from > 0 && !REFERENCE_OPENER.test(text[from - 1]!)
                 ? undefined
                 : names.find((candidate) => text.startsWith(candidate, from + 1) && isTokenEnd(text[from + 1 + candidate.length]));
+
         const to = name === undefined ? from + 1 : from + 1 + name.length;
         const ids = name === undefined ? [] : byName.get(name)!;
         const id = ids.find((candidate) => preferred.has(candidate)) ?? (ids.length === 1 ? ids[0] : undefined);
+
         if (id !== undefined && !excluded.some((range) => from < range.to && to > range.from)) {
             ranges.push({ from, to, kind: 'reference', value: id });
         }
+
         index = text.indexOf('#', to);
     }
+
     return ranges;
 }
 
@@ -383,15 +435,19 @@ export function tokenizeNamedReferences(text: string, items: readonly ReferenceT
 function segmentsOf(text: string, ranges: readonly ChipRange[]): ChipSegment[] {
     const segments: ChipSegment[] = [];
     let cursor = 0;
+
     for (const range of ranges) {
         if (range.from > cursor) {
             segments.push({ kind: 'text', text: text.slice(cursor, range.from) });
         }
+
         segments.push(segmentOf(text, range));
         cursor = range.to;
     }
+
     if (cursor < text.length) {
         segments.push({ kind: 'text', text: text.slice(cursor) });
     }
+
     return segments;
 }

package/src/chat/pending-prompts.ts

@@ -40,9 +40,11 @@ export class ChatPromptFeed {
     dispose(): void {
         this.disposed = true;
         this.unsubscribe?.();
+
         for (const release of this.children.values()) {
             release();
         }
+
         this.children.clear();
     }
 
@@ -50,49 +52,63 @@ export class ChatPromptFeed {
         if (this.disposed) {
             return;
         }
+
         const store = useChats.getState();
         const subjects = new Map<string, ChatPromptSubject>();
         const seen = new Set<string>();
+
         const visit = (chatId: string, source?: ChatPromptSubject['source']): void => {
             if (seen.has(chatId)) {
                 return;
             }
+
             seen.add(chatId);
             const key = this.scope.keyOf(chatId);
             const row = store.byKey[key];
             const info = store.statusByKey[key]?.info ?? row?.info;
+
             for (const item of waitingRequestsOf(row)) {
                 if (info !== undefined && (chatId === this.chatId || stillWaiting(item, info))) {
                     subjects.set(`${chatId}:${item.requestId}`, { kind: 'chat', nodeId: chatId, item, ...(source === undefined ? {} : { source }) });
                 }
             }
+
             for (const item of Object.values(row?.structure ?? {})) {
                 if (item.kind !== 'subagent' || item.childId === undefined || seen.has(item.childId)) {
                     continue;
                 }
+
                 const childInfo = store.statusByKey[this.scope.keyOf(item.childId)]?.info;
+
                 if (item.status !== 'running' && childInfo?.status !== 'needs-you') {
                     continue;
                 }
+
                 if (!this.children.has(item.childId)) {
                     this.children.set(item.childId, this.scope.chats.observe(item.childId));
                 }
+
                 visit(item.childId, { label: subagentTitle(item), provider: childInfo?.provider });
             }
         };
+
         visit(this.chatId);
+
         for (const [chatId, release] of this.children) {
             if (!seen.has(chatId)) {
                 this.children.delete(chatId);
                 release();
             }
         }
+
         const next = [...subjects.values()];
+
         if (
             this.current === null ||
             next.length !== this.current.length ||
             next.some((subject, index) => {
                 const previous = this.current?.[index];
+
                 return (
                     subject.nodeId !== previous?.nodeId ||
                     subject.item !== previous.item ||

package/src/chat/persisted-json.ts

@@ -14,22 +14,30 @@ export function persistedJson<T>(
 ): PersistedJson<T> {
     let memory = fallback;
     let unwritten = false;
+
     const currentKey = (): string => (typeof key === 'string' ? key : key());
+
     return {
         read: () => {
             hydrateChatStorage();
+
             if (unwritten) {
                 return memory;
             }
+
             try {
                 const storage = chatStorageAdapter();
+
                 if (!storage) {
                     return memory;
                 }
+
                 let raw = storage.getItem(currentKey());
+
                 if (raw === null) {
                     for (const legacy of legacyKeys()) {
                         raw = storage.getItem(legacy);
+
                         if (raw !== null) {
                             // Keep the old key for clients still using it, and migrate without changing the record.
                             try {
@@ -37,11 +45,14 @@ export function persistedJson<T>(
                             } catch {
                                 // A full storage still lets the existing record be read.
                             }
+
                             break;
                         }
                     }
                 }
+
                 memory = parse(raw);
+
                 return memory;
             } catch {
                 return memory;
@@ -51,13 +62,17 @@ export function persistedJson<T>(
             hydrateChatStorage();
             memory = value;
             unwritten = true;
+
             try {
                 const storage = chatStorageAdapter();
+
                 if (!storage) {
                     return false;
                 }
+
                 storage.setItem(currentKey(), JSON.stringify(value));
                 unwritten = false;
+
                 return true;
             } catch {
                 return false;

package/src/chat/preferences.ts

@@ -43,9 +43,11 @@ function parseFavoriteModels(stored: unknown): Partial<Record<AgentKind, string[
     if (typeof stored !== 'object' || stored === null || Array.isArray(stored)) {
         return {};
     }
+
     return Object.fromEntries(
         Object.entries(stored).flatMap(([provider, slugs]) => {
             const kept = Array.isArray(slugs) ? slugs.filter((slug): slug is string => typeof slug === 'string' && slug !== '') : [];
+
             return kept.length === 0 ? [] : [[provider, kept]];
         })
     );
@@ -60,8 +62,10 @@ export function parseChatPreferences(raw: string | null): ChatPreferences {
     if (raw === null) {
         return DEFAULT_CHAT_PREFERENCES;
     }
+
     try {
         const stored = JSON.parse(raw) as Partial<ChatPreferences>;
+
         return {
             selectionByProvider: { ...stored.selectionByProvider },
             lastProvider: stored.lastProvider ?? null,
@@ -86,9 +90,11 @@ export function defaultProvider(preferences: ChatPreferences): AgentKind | null
 /* The model a chat of this provider starts with; null lets the host fall back to the CLI's own default. */
 export function selectionFor(preferences: ChatPreferences, provider: AgentKind | null | undefined): ModelSelection | null {
     const owner = provider ?? preferences.lastProvider;
+
     if (owner === null) {
         return null;
     }
+
     return preferences.selectionByProvider[owner] ?? null;
 }
 
@@ -112,10 +118,13 @@ export function withSelection(preferences: ChatPreferences, provider: AgentKind,
  */
 export function accountFor(preferences: ChatPreferences, scopeId: string, provider: AgentKind, accounts?: ProviderAccounts | null): string | null {
     const picked = preferences.accountByMachine[scopeId]?.[provider] ?? null;
+
     if (picked === null || accounts === undefined) {
         return picked;
     }
+
     const account = accounts?.accounts[picked];
+
     return account?.kind === provider && account.enabled !== false ? picked : null;
 }
 
@@ -124,6 +133,7 @@ export function withAccount(preferences: ChatPreferences, scopeId: string, provi
     const { [provider]: _previous, ...others } = preferences.accountByMachine[scopeId] ?? {};
     const picks = account === null || account === provider ? others : { ...others, [provider]: account };
     const { [scopeId]: _machine, ...machines } = preferences.accountByMachine;
+
     return { ...preferences, accountByMachine: Object.keys(picks).length === 0 ? machines : { ...machines, [scopeId]: picks } };
 }
 
@@ -131,8 +141,10 @@ export function withAccount(preferences: ChatPreferences, scopeId: string, provi
 export function chatPreferencesPayload(preferences: ChatPreferences, scopeId: string, accounts?: ProviderAccounts | null): ChatPreferencesPayload {
     const picks = Object.keys(preferences.accountByMachine[scopeId] ?? {}).flatMap((provider) => {
         const account = accountFor(preferences, scopeId, provider as AgentKind, accounts);
+
         return account === null ? [] : [[provider, account] as const];
     });
+
     return {
         runtimeMode: preferences.runtimeMode,
         terminalRuntimeMode: preferences.terminalRuntimeMode,
@@ -156,6 +168,7 @@ export function readChatPreferences(): ChatPreferences {
 
 /* Where the remembered default is kept, which an app with more than one window of the same origin listens for. */
 export let CHAT_PREFERENCES_KEY = storageKey();
+
 onChatStorageConfiguration(() => {
     CHAT_PREFERENCES_KEY = storageKey();
 });
@@ -192,6 +205,7 @@ export function rememberSendKey(sendKey: ChatSendKey): void {
 export function rememberChatSelection(provider: AgentKind, selection: ModelSelection): void {
     const current = useChatPreferences.getState();
     const previous = current.selectionByProvider[provider];
+
     if (
         current.lastProvider === provider &&
         previous?.model === selection.model &&
@@ -200,6 +214,7 @@ export function rememberChatSelection(provider: AgentKind, selection: ModelSelec
     ) {
         return;
     }
+
     write(withSelection(current, provider, selection));
 }
 
@@ -217,6 +232,7 @@ export function withFavoriteToggled(preferences: ChatPreferences, provider: Agen
     const current = preferences.favoriteModels[provider] ?? [];
     const next = current.includes(slug) ? current.filter((each) => each !== slug) : [...current, slug];
     const { [provider]: _previous, ...others } = preferences.favoriteModels;
+
     return { ...preferences, favoriteModels: next.length === 0 ? others : { ...others, [provider]: next } };
 }
 

package/src/chat/prompt-hold.ts

@@ -15,6 +15,7 @@ export function holdsPrompt(input: HoldInput, now: number): boolean {
     if (input.composing) {
         return true;
     }
+
     return input.typedAt !== null && now - input.typedAt < PROMPT_HOLD_PAUSE_MS;
 }
 
@@ -23,5 +24,6 @@ export function holdLiftsIn(input: HoldInput, now: number): number | null {
     if (input.composing || input.typedAt === null) {
         return null;
     }
+
     return Math.max(0, input.typedAt + PROMPT_HOLD_PAUSE_MS - now);
 }