@adonis-agora/agent/dist/src/react/core/presentation/phrasing.js

Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.

import { fillPresentationTemplate, readPresentationPath } from '../../../tool-presentation.js';
/** Index `GET <base>/tools` by tool name, keeping only the tools that declared a presentation. */
export function toolCatalogFrom(entries) {
    const catalog = {};
    for (const entry of entries) {
        if (entry.presentation !== undefined)
            catalog[entry.name] = entry.presentation;
    }
    return catalog;
}
/** Dotted-path read. `undefined` rather than a throw, so a template can outlive a field. */
export const readPath = readPresentationPath;
/**
 * Fill `{dotted.path}` placeholders from `context`. A placeholder with nothing behind it collapses
 * along with the whitespace in front of it, so "Reading {key}" degrades to "Reading" rather than
 * printing braces at a person; a filled one keeps the whitespace the author wrote ("({n} files)").
 * The same filler the server resolves approval prompts with.
 */
export const fillTemplate = fillPresentationTemplate;
/**
 * The sentence for one call: the presentation's `running` or `done` template over the call's input.
 *
 * Nothing here reads the tool's name. A tool the catalog does not describe — added since the catalog
 * loaded, or declared without a presentation — is narrated generically (`fallback`), because the only
 * other thing available to say is its identifier.
 */
export function phraseFor(presentation, input, isSettled, fallback = { running: 'Working', done: 'Done' }) {
    if (presentation === undefined)
        return isSettled ? fallback.done : fallback.running;
    const filled = fillTemplate(isSettled ? presentation.done : presentation.running, input);
    // A sentence made only of slots, called before those fields have streamed, leaves nothing. The
    // label is still the server's word for this tool, and a blank line reads as nothing happening.
    return filled === '' ? presentation.label : filled;
}
//# sourceMappingURL=phrasing.js.map