@adecore/agents-react 0.31.11 → 0.32.0

package/dist/chat/logic/command-looks.js

@@ -6,95 +6,135 @@ const CACHE_LIMIT = 300;
 const caches = new WeakMap();
 /* The look of a simple command and what it says about it, or null when no look knows it. */
 function lookOf(command, looks) {
-    const program = command.program;
-    if (program === null) {
-        return null;
+  const program = command.program;
+  if (program === null) {
+    return null;
+  }
+  const args = command.words.slice(program.index + 1).map(({
+    text
+  }) => text);
+  for (const look of looks) {
+    if (look.program !== program.name) {
+      continue;
     }
-    const args = command.words.slice(program.index + 1).map(({ text }) => text);
-    for (const look of looks) {
-        if (look.program !== program.name) {
-            continue;
-        }
-        const match = look.describe(args);
-        if (match !== null) {
-            return { look, match };
-        }
+    const match = look.describe(args);
+    if (match !== null) {
+      return {
+        look,
+        match
+      };
     }
-    return null;
+  }
+  return null;
 }
 /* The source of `word`, with its value cut past the fold; the body comes back as offsets into what is returned. */
 function foldedWord(source, word, fold) {
-    const text = source.slice(word.start, word.end);
-    const body = word.body === null ? null : { start: word.body.start - word.start, end: word.body.end - word.start };
-    if (!fold) {
-        return { text, body };
-    }
-    if (body !== null && body.end - body.start > FOLD_LENGTH) {
-        const cut = body.start + FOLD_LENGTH;
-        return { text: `${text.slice(0, cut)}…${text.slice(body.end)}`, body: { start: body.start, end: cut + 1 } };
-    }
-    if (body === null && text.length > FOLD_LENGTH) {
-        return { text: `${text.slice(0, FOLD_LENGTH)}…`, body: null };
-    }
-    return { text, body };
+  const text = source.slice(word.start, word.end);
+  const body = word.body === null ? null : {
+    start: word.body.start - word.start,
+    end: word.body.end - word.start
+  };
+  if (!fold) {
+    return {
+      text,
+      body
+    };
+  }
+  if (body !== null && body.end - body.start > FOLD_LENGTH) {
+    const cut = body.start + FOLD_LENGTH;
+    return {
+      text: `${text.slice(0, cut)}…${text.slice(body.end)}`,
+      body: {
+        start: body.start,
+        end: cut + 1
+      }
+    };
+  }
+  if (body === null && text.length > FOLD_LENGTH) {
+    return {
+      text: `${text.slice(0, FOLD_LENGTH)}…`,
+      body: null
+    };
+  }
+  return {
+    text,
+    body
+  };
 }
 /* The detail of a command from the word the match names: its words with their spacing, a redirect or heredoc between them a single space. */
 function detailOf(source, command, match) {
-    const first = command.program.index + 1 + Math.max(0, match.detailFrom);
-    let detail = '';
-    const code = [];
-    const words = [];
-    let previous = null;
-    // The option the word before was, whose value this word may be.
-    let option = null;
-    for (const word of command.words.slice(first)) {
-        if (previous !== null) {
-            const gap = source.slice(previous.end, word.start);
-            detail += /^[ \t]*$/.test(gap) ? gap : ' ';
-        }
-        const start = detail.length;
-        const { text, body } = foldedWord(source, word, option !== null && match.fold?.includes(option) === true);
-        const language = option === null ? undefined : match.languages?.[option];
-        if (language !== undefined && body !== null && body.end > body.start) {
-            code.push({ start: start + body.start, end: start + body.end, language });
-        }
-        detail += text;
-        const isOption = word.text.startsWith('-') && word.text !== '-';
-        if (!isOption) {
-            words.push({ start, end: detail.length, text: word.text, option });
-        }
-        option = isOption ? word.text : null;
-        previous = word;
+  const first = command.program.index + 1 + Math.max(0, match.detailFrom);
+  let detail = '';
+  const code = [];
+  const words = [];
+  let previous = null;
+  // The option the word before was, whose value this word may be.
+  let option = null;
+  for (const word of command.words.slice(first)) {
+    if (previous !== null) {
+      const gap = source.slice(previous.end, word.start);
+      detail += /^[ \t]*$/.test(gap) ? gap : ' ';
+    }
+    const start = detail.length;
+    const {
+      text,
+      body
+    } = foldedWord(source, word, option !== null && match.fold?.includes(option) === true);
+    const language = option === null ? undefined : match.languages?.[option];
+    if (language !== undefined && body !== null && body.end > body.start) {
+      code.push({
+        start: start + body.start,
+        end: start + body.end,
+        language
+      });
     }
-    return { detail, code, words };
+    detail += text;
+    const isOption = word.text.startsWith('-') && word.text !== '-';
+    if (!isOption) {
+      words.push({
+        start,
+        end: detail.length,
+        text: word.text,
+        option
+      });
+    }
+    option = isOption ? word.text : null;
+    previous = word;
+  }
+  return {
+    detail,
+    code,
+    words
+  };
 }
 function read(command, looks) {
-    let found = null;
-    let more = 0;
-    const others = [];
-    for (const simple of shellCommands(command)) {
-        const known = lookOf(simple, looks);
-        if (known !== null && found === null) {
-            found = { command: simple, ...known };
-        }
-        else if (known !== null) {
-            more++;
-        }
-        else if (simple.program !== null && !others.includes(simple.program.name)) {
-            others.push(simple.program.name);
-        }
-    }
-    if (found === null) {
-        return null;
+  let found = null;
+  let more = 0;
+  const others = [];
+  for (const simple of shellCommands(command)) {
+    const known = lookOf(simple, looks);
+    if (known !== null && found === null) {
+      found = {
+        command: simple,
+        ...known
+      };
+    } else if (known !== null) {
+      more++;
+    } else if (simple.program !== null && !others.includes(simple.program.name)) {
+      others.push(simple.program.name);
     }
-    return {
-        look: found.look,
-        match: found.match,
-        ...detailOf(command, found.command, found.match),
-        others,
-        more,
-        heredoc: found.command.heredocs.length > 0
-    };
+  }
+  if (found === null) {
+    return null;
+  }
+  return {
+    look: found.look,
+    match: found.match,
+    ...detailOf(command, found.command, found.match),
+    others,
+    more,
+    heredoc: found.command.heredocs.length > 0
+  };
 }
 /*
  * The first command of a shell line that one of `looks` knows, read as that look's tool: a program
@@ -102,22 +142,24 @@ function read(command, looks) {
  * `tool`. Null for a line no look knows, and for one past the length that is drawn without looking inside.
  */
 export function matchCommandLook(command, looks) {
-    if (looks === undefined || looks.length === 0 || command.length > EMBEDDED_CODE_LIMIT || !looks.some(({ program }) => command.includes(program))) {
-        return null;
-    }
-    let cache = caches.get(looks);
-    if (cache === undefined) {
-        cache = new Map();
-        caches.set(looks, cache);
-    }
-    const known = cache.get(command);
-    if (known !== undefined) {
-        return known;
-    }
-    const run = read(command, looks);
-    cache.set(command, run);
-    if (cache.size > CACHE_LIMIT) {
-        cache.delete(cache.keys().next().value);
-    }
-    return run;
-}
+  if (looks === undefined || looks.length === 0 || command.length > EMBEDDED_CODE_LIMIT || !looks.some(({
+    program
+  }) => command.includes(program))) {
+    return null;
+  }
+  let cache = caches.get(looks);
+  if (cache === undefined) {
+    cache = new Map();
+    caches.set(looks, cache);
+  }
+  const known = cache.get(command);
+  if (known !== undefined) {
+    return known;
+  }
+  const run = read(command, looks);
+  cache.set(command, run);
+  if (cache.size > CACHE_LIMIT) {
+    cache.delete(cache.keys().next().value);
+  }
+  return run;
+}

package/dist/chat/logic/context-usage.js

@@ -1,21 +1,25 @@
 export const CONTEXT_OPTION = 'contextWindow';
 export const CONTEXT_PARTS = ['toolOutput', 'filesRead', 'conversation', 'system'];
 export function contextFraction(usage) {
-    return usage.contextWindow ? Math.min(1, usage.contextTokens / usage.contextWindow) : 0;
+  return usage.contextWindow ? Math.min(1, usage.contextTokens / usage.contextWindow) : 0;
 }
 /* The stretches of the bar, in the legend's order; null from a host that does not estimate, which draws the plain bar. */
 export function contextSegments(usage) {
-    const breakdown = usage.breakdown;
-    if (!breakdown || usage.contextTokens === 0) {
-        return null;
-    }
-    const whole = Math.max(usage.contextWindow ?? 0, usage.contextTokens);
-    return CONTEXT_PARTS.map((part) => ({ part, tokens: breakdown[part], fraction: breakdown[part] / whole }));
+  const breakdown = usage.breakdown;
+  if (!breakdown || usage.contextTokens === 0) {
+    return null;
+  }
+  const whole = Math.max(usage.contextWindow ?? 0, usage.contextTokens);
+  return CONTEXT_PARTS.map(part => ({
+    part,
+    tokens: breakdown[part],
+    fraction: breakdown[part] / whole
+  }));
 }
 /*
  * The model's own knobs with the context window last: its details sit in the group right under it,
  * and a switch like Fast mode belongs with the reasoning choice above rather than below the size.
  */
 export function orderOptions(options) {
-    return [...options.filter((option) => option.id !== CONTEXT_OPTION), ...options.filter((option) => option.id === CONTEXT_OPTION)];
-}
+  return [...options.filter(option => option.id !== CONTEXT_OPTION), ...options.filter(option => option.id === CONTEXT_OPTION)];
+}

package/dist/chat/logic/continue-after-stop.js

@@ -7,22 +7,18 @@ export const CONTINUE_PROMPT = 'Continue.';
  * and a request that waits on a person comes first.
  */
 export function continuableTurn(info, items) {
-    if (info.activeTurnId !== null ||
-        info.status === 'needs-you' ||
-        (info.queue ?? []).length > 0 ||
-        info.limit !== undefined ||
-        info.goal?.status === 'paused') {
-        return null;
-    }
-    const index = items.findLastIndex((item) => item.kind === 'turn');
-    const turn = items[index];
-    if (turn?.kind !== 'turn' || turn.state !== 'aborted' || turn.limit !== undefined || abortedByMachine(turn, items) || abortedByEnd(turn, items)) {
-        return null;
-    }
-    // A message of this turn sits after the turn item too, so only one sent after the turn ended counts.
-    const endedAt = turn.endedAt ?? turn.createdAt;
-    if (items.slice(index + 1).some((item) => item.kind === 'user' && item.createdAt > endedAt)) {
-        return null;
-    }
-    return turn.id;
-}
+  if (info.activeTurnId !== null || info.status === 'needs-you' || (info.queue ?? []).length > 0 || info.limit !== undefined || info.goal?.status === 'paused') {
+    return null;
+  }
+  const index = items.findLastIndex(item => item.kind === 'turn');
+  const turn = items[index];
+  if (turn?.kind !== 'turn' || turn.state !== 'aborted' || turn.limit !== undefined || abortedByMachine(turn, items) || abortedByEnd(turn, items)) {
+    return null;
+  }
+  // A message of this turn sits after the turn item too, so only one sent after the turn ended counts.
+  const endedAt = turn.endedAt ?? turn.createdAt;
+  if (items.slice(index + 1).some(item => item.kind === 'user' && item.createdAt > endedAt)) {
+    return null;
+  }
+  return turn.id;
+}

package/dist/chat/logic/effort.d.ts

@@ -0,0 +1,14 @@
+import type { ModelInfo, ModelOptionChoice, ModelSelection } from '@adecore/agent-contracts';
+export declare const EFFORT_OPTION = "effort";
+export type EffortStep = 'up' | 'down';
+export type EffortStepResult = {
+    kind: 'stepped';
+    selection: ModelSelection;
+    choice: ModelOptionChoice;
+} | {
+    kind: 'edge';
+    choice: ModelOptionChoice;
+} | {
+    kind: 'none';
+};
+export declare function stepEffort(model: ModelInfo | undefined, selection: ModelSelection, step: EffortStep): EffortStepResult;

package/dist/chat/logic/effort.js

@@ -0,0 +1,34 @@
+/* The option a catalog names the reasoning effort by; its choices run from the least to the most. */
+export const EFFORT_OPTION = 'effort';
+/* One step of effort within what the model offers. A value the model no longer offers counts as its default. */
+export function stepEffort(model, selection, step) {
+  const option = model?.options.find(candidate => candidate.id === EFFORT_OPTION);
+  if (option === undefined || option.type !== 'select') {
+    return {
+      kind: 'none'
+    };
+  }
+  const chosen = selection.options[EFFORT_OPTION];
+  const index = option.choices.findIndex(choice => choice.id === chosen);
+  const from = index === -1 ? option.choices.findIndex(choice => choice.id === option.defaultChoice) : index;
+  const current = Math.max(0, from);
+  const next = current + (step === 'up' ? 1 : -1);
+  const choice = option.choices[next];
+  if (choice === undefined) {
+    return {
+      kind: 'edge',
+      choice: option.choices[current]
+    };
+  }
+  return {
+    kind: 'stepped',
+    selection: {
+      ...selection,
+      options: {
+        ...selection.options,
+        [EFFORT_OPTION]: choice.id
+      }
+    },
+    choice
+  };
+}