@adonis-agora/agent 0.60.1 → 0.62.0

package/dist/src/react/core/composer/index.d.ts

@@ -0,0 +1,4 @@
+export { type AutocompleteItem, type AutocompleteSource, applyCompletion, type CompletionEdit, filterAutocompleteItems, findActiveTrigger, type TriggerMatch, type TriggerPosition, } from './model.js';
+export { createSkillsSource, type SkillSuggestionData, type SkillsSourceOptions, } from './skills-source.js';
+export { type AutocompleteInputProps, type AutocompleteListboxProps, type AutocompleteOptionProps, type ComposerAutocomplete, type UseComposerAutocompleteOptions, useComposerAutocomplete, } from './use-composer-autocomplete.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/react/core/composer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/composer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,eAAe,EACf,KAAK,cAAc,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,8BAA8B,EACnC,uBAAuB,GACxB,MAAM,gCAAgC,CAAC"}

package/dist/src/react/core/composer/index.js

@@ -0,0 +1,4 @@
+export { applyCompletion, filterAutocompleteItems, findActiveTrigger, } from './model.js';
+export { createSkillsSource, } from './skills-source.js';
+export { useComposerAutocomplete, } from './use-composer-autocomplete.js';
+//# sourceMappingURL=index.js.map

package/dist/src/react/core/composer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/react/core/composer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,eAAe,EAEf,uBAAuB,EACvB,iBAAiB,GAGlB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAML,uBAAuB,GACxB,MAAM,gCAAgC,CAAC"}

package/dist/src/react/core/composer/model.d.ts

@@ -0,0 +1,83 @@
+/** One completion a source offers. */
+export interface AutocompleteItem {
+    /** Unique within its source. */
+    id: string;
+    /** What the reader sees, and what the default filter matches against. */
+    label: string;
+    /** What replaces the typed token. Defaults to `label` — set it when the label is prose. */
+    value?: string;
+    description?: string;
+    /**
+     * A short trailing note a renderer right-aligns — where this came from, a keyboard shortcut, a
+     * type. Deliberately outside the default filter: typing a query should narrow by what the item
+     * IS, not by an aside about it.
+     */
+    hint?: string;
+    /** Whatever the host's renderer needs: an icon key, a scope, the row this came from. */
+    data?: unknown;
+}
+/**
+ * Where a trigger character is allowed to open the menu.
+ *
+ * - `'start'` — only as the very first character of the input. This is the rule a slash command
+ *   wants: `/deploy` is a command, `src/foo` and `and/or` are not.
+ * - `'word'` — at the start of any word: the input's start, or immediately after whitespace. This
+ *   is the rule a mention wants: `@ada` in the middle of a sentence is a mention, `ada@example` is
+ *   an address.
+ *
+ * There is no default on purpose. Which rule a trigger takes is the difference between an
+ * autocomplete that feels invisible and one that fires while somebody types a file path.
+ */
+export type TriggerPosition = 'start' | 'word';
+export interface AutocompleteSource {
+    /** Identifies the source to the host; also names the listbox when `label` is omitted. */
+    id: string;
+    /** Human-facing name for the open menu. */
+    label?: string;
+    /** The single character that opens this source. Two sources never share one. */
+    trigger: string;
+    position: TriggerPosition;
+    /**
+     * The candidates for `query`. May be async; a result that arrives after the query moved on is
+     * discarded, and `signal` aborts the request that produced it. Throwing is allowed — the menu
+     * reports the failure and typing carries on.
+     */
+    getItems: (query: string, signal: AbortSignal) => AutocompleteItem[] | Promise<AutocompleteItem[]>;
+    /**
+     * Narrow what `getItems` returned. Defaults to {@link filterAutocompleteItems}. A source that
+     * already filtered server-side — a fuzzy match this one would undo — passes `(items) => items`.
+     */
+    filter?: (items: AutocompleteItem[], query: string) => AutocompleteItem[];
+    /**
+     * Appended after the inserted value. Defaults to a single space, which both closes the menu and
+     * puts the caret where the command's argument goes.
+     */
+    insertSuffix?: string;
+}
+/** A trigger character found before the caret, with the token being typed after it. */
+export interface TriggerMatch {
+    source: AutocompleteSource;
+    /** Index of the trigger character itself. */
+    index: number;
+    /** The text between the trigger and the caret. Never contains whitespace. */
+    query: string;
+}
+export interface CompletionEdit {
+    text: string;
+    caret: number;
+}
+/**
+ * The trigger token the caret currently sits in, or `null`. Scans backwards from the caret and
+ * stops at the first whitespace, so a token is always one unbroken word: typing a space is what
+ * ends a command and hands the rest of the line back to the user as prose.
+ */
+export declare function findActiveTrigger(text: string, caret: number, sources: readonly AutocompleteSource[]): TriggerMatch | null;
+/** Case-insensitive substring over label and description. The default when a source names none. */
+export declare function filterAutocompleteItems(items: readonly AutocompleteItem[], query: string): AutocompleteItem[];
+/**
+ * The text and caret after accepting `item`. The trigger character stays — `/deploy ` is what the
+ * user meant to type — and everything after the caret is left untouched, so completing a token in
+ * the middle of a sentence does not eat the rest of it.
+ */
+export declare function applyCompletion(text: string, caret: number, match: TriggerMatch, item: AutocompleteItem): CompletionEdit;
+//# sourceMappingURL=model.d.ts.map

package/dist/src/react/core/composer/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/composer/model.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,yFAAyF;IACzF,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,EAAE,CACR,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,KAChB,gBAAgB,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACtD;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;IAC1E;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,uFAAuF;AACvF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,YAAY,GAAG,IAAI,CAerB;AAaD,mGAAmG;AACnG,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAClC,KAAK,EAAE,MAAM,GACZ,gBAAgB,EAAE,CAQpB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,gBAAgB,GACrB,cAAc,CAOhB"}

package/dist/src/react/core/composer/model.js

@@ -0,0 +1,53 @@
+const WHITESPACE = /\s/;
+/**
+ * The trigger token the caret currently sits in, or `null`. Scans backwards from the caret and
+ * stops at the first whitespace, so a token is always one unbroken word: typing a space is what
+ * ends a command and hands the rest of the line back to the user as prose.
+ */
+export function findActiveTrigger(text, caret, sources) {
+    const end = Math.max(0, Math.min(caret, text.length));
+    for (let index = end - 1; index >= 0; index--) {
+        const char = text[index];
+        if (char === undefined || WHITESPACE.test(char)) {
+            return null;
+        }
+        const source = sources.find((candidate) => candidate.trigger === char);
+        // A trigger that fails its own position rule is just a character in the token — `@ad/x` is one
+        // mention query, not a command — so the scan continues past it rather than giving up.
+        if (source && isAllowedAt(text, index, source.position)) {
+            return { source, index, query: text.slice(index + 1, end) };
+        }
+    }
+    return null;
+}
+function isAllowedAt(text, index, position) {
+    if (index === 0) {
+        return true;
+    }
+    if (position === 'start') {
+        return false;
+    }
+    const previous = text[index - 1];
+    return previous !== undefined && WHITESPACE.test(previous);
+}
+/** Case-insensitive substring over label and description. The default when a source names none. */
+export function filterAutocompleteItems(items, query) {
+    // An empty needle is a substring of everything, so it needs no branch of its own.
+    const needle = query.trim().toLowerCase();
+    return items.filter((item) => item.label.toLowerCase().includes(needle) ||
+        (item.description?.toLowerCase().includes(needle) ?? false));
+}
+/**
+ * The text and caret after accepting `item`. The trigger character stays — `/deploy ` is what the
+ * user meant to type — and everything after the caret is left untouched, so completing a token in
+ * the middle of a sentence does not eat the rest of it.
+ */
+export function applyCompletion(text, caret, match, item) {
+    const end = Math.max(match.index, Math.min(caret, text.length));
+    const inserted = `${match.source.trigger}${item.value ?? item.label}${match.source.insertSuffix ?? ' '}`;
+    return {
+        text: text.slice(0, match.index) + inserted + text.slice(end),
+        caret: match.index + inserted.length,
+    };
+}
+//# sourceMappingURL=model.js.map

package/dist/src/react/core/composer/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../../src/react/core/composer/model.ts"],"names":[],"mappings":"AA4EA,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,KAAa,EACb,OAAsC;IAEtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,KAAK,IAAI,KAAK,GAAG,GAAG,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;QACvE,+FAA+F;QAC/F,sFAAsF;QACtF,IAAI,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa,EAAE,QAAyB;IACzE,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACjC,OAAO,QAAQ,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,uBAAuB,CACrC,KAAkC,EAClC,KAAa;IAEb,kFAAkF;IAClF,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,OAAO,KAAK,CAAC,MAAM,CACjB,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QACzC,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAC9D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAAa,EACb,KAAmB,EACnB,IAAsB;IAEtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,IAAI,GAAG,EAAE,CAAC;IACzG,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAC7D,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM;KACrC,CAAC;AACJ,CAAC"}

package/dist/src/react/core/composer/skills-source.d.ts

@@ -0,0 +1,29 @@
+import { type AgentBackend } from '../backend.js';
+import type { AutocompleteSource } from './model.js';
+/** What each item carries on `data`, so a renderer can show where a skill came from. */
+export interface SkillSuggestionData {
+    /** The scope token it resolved from — the provenance a user is entitled to see. */
+    scope: string;
+    /** Scope tokens of same-named skills this one outranks, widest last. */
+    shadows?: string[];
+}
+export interface SkillsSourceOptions {
+    /** Any backend with `listSkills` — `useAgentBackend()`, or `useAgentChat().backend`. */
+    backend: Pick<AgentBackend, 'listSkills'>;
+    /**
+     * Read at query time, not captured once: a threadless chat learns its id only when the backend
+     * creates one on the first send, and a skill may be scoped to a conversation.
+     */
+    getThreadId?: () => string | undefined;
+    /** Default `/`. */
+    trigger?: string;
+    /** Default `Skills`. */
+    label?: string;
+}
+/**
+ * `GET /agent/skills` as an autocomplete source — the concrete one behind `/`, and an example of
+ * the shape any other takes. `position: 'start'` because a skill is a command: `/deploy` is one and
+ * `src/foo` is a path.
+ */
+export declare function createSkillsSource(options: SkillsSourceOptions): AutocompleteSource;
+//# sourceMappingURL=skills-source.d.ts.map

package/dist/src/react/core/composer/skills-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-source.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/composer/skills-source.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAgC,MAAM,eAAe,CAAC;AAChF,OAAO,KAAK,EAAoB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvE,wFAAwF;AACxF,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAC1C;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACvC,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAqCnF"}

package/dist/src/react/core/composer/skills-source.js

@@ -0,0 +1,61 @@
+import { AgentBackendUnsupportedError } from '../backend.js';
+/**
+ * `GET /agent/skills` as an autocomplete source — the concrete one behind `/`, and an example of
+ * the shape any other takes. `position: 'start'` because a skill is a command: `/deploy` is one and
+ * `src/foo` is a path.
+ */
+export function createSkillsSource(options) {
+    // One read per thread. The endpoint answers with the whole scope-resolved list rather than a
+    // search, so asking again per keystroke would fetch identical rows only to filter them locally.
+    // A failed read is forgotten, so the next keystroke retries instead of caching the outage.
+    //
+    // The order it arrives in IS the precedence — most specific scope first, then alphabetical — and
+    // is passed through untouched. The type-ahead filter narrows this list by what the user typed; it
+    // never re-derives which skills apply, which is the server's answer and the model's too.
+    const byThread = new Map();
+    return {
+        id: 'skills',
+        label: options.label ?? 'Skills',
+        trigger: options.trigger ?? '/',
+        position: 'start',
+        getItems: () => {
+            const threadId = options.getThreadId?.();
+            const key = threadId ?? '';
+            const cached = byThread.get(key);
+            if (cached) {
+                return cached;
+            }
+            const listSkills = options.backend.listSkills;
+            if (listSkills === undefined) {
+                return Promise.reject(new AgentBackendUnsupportedError('listSkills'));
+            }
+            const pending = listSkills
+                .call(options.backend, threadId)
+                .then((entries) => entries.map(toItem))
+                .catch((error) => {
+                byThread.delete(key);
+                throw error;
+            });
+            byThread.set(key, pending);
+            return pending;
+        },
+    };
+}
+function toItem(entry) {
+    const data = {
+        scope: entry.scope,
+        ...(entry.shadows !== undefined ? { shadows: entry.shadows } : {}),
+    };
+    return {
+        id: entry.name,
+        label: entry.name,
+        description: entry.description,
+        // `shadows` is present only on a conflict, so saying "overrides" is never noise: without it a
+        // user cannot tell "there is no org default" from "there is one and mine wins".
+        hint: entry.shadows === undefined
+            ? entry.scope
+            : `${entry.scope} · overrides ${entry.shadows.join(', ')}`,
+        data,
+    };
+}
+//# sourceMappingURL=skills-source.js.map

package/dist/src/react/core/composer/skills-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-source.js","sourceRoot":"","sources":["../../../../../src/react/core/composer/skills-source.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAyBhF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,6FAA6F;IAC7F,gGAAgG;IAChG,2FAA2F;IAC3F,EAAE;IACF,iGAAiG;IACjG,kGAAkG;IAClG,yFAAyF;IACzF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuC,CAAC;IAEhE,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,QAAQ;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,GAAG;QAC/B,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,GAAG,EAAE;YACb,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,QAAQ,IAAI,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;YAC9C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,4BAA4B,CAAC,YAAY,CAAC,CAAC,CAAC;YACxE,CAAC;YACD,MAAM,OAAO,GAAG,UAAU;iBACvB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;iBAC/B,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;iBACtC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACxB,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACrB,MAAM,KAAK,CAAC;YACd,CAAC,CAAC,CAAC;YACL,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC3B,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,KAAwB;IACtC,MAAM,IAAI,GAAwB;QAChC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;IACF,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,IAAI;QACd,KAAK,EAAE,KAAK,CAAC,IAAI;QACjB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,8FAA8F;QAC9F,gFAAgF;QAChF,IAAI,EACF,KAAK,CAAC,OAAO,KAAK,SAAS;YACzB,CAAC,CAAC,KAAK,CAAC,KAAK;YACb,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,gBAAgB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC9D,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/src/react/core/composer/use-composer-autocomplete.d.ts

@@ -0,0 +1,78 @@
+import type React from 'react';
+import { type AutocompleteItem, type AutocompleteSource } from './model.js';
+export interface UseComposerAutocompleteOptions {
+    /** The composer's draft. Accepting an item rewrites it through `onValueChange`. */
+    value: string;
+    onValueChange: (next: string) => void;
+    /**
+     * What can be completed, and after which character. The composer knows nothing about what a
+     * source offers — a skills list and an agent mention are the same shape.
+     */
+    sources: readonly AutocompleteSource[];
+    /** A source that threw. The menu reports it; typing is unaffected either way. */
+    onError?: (error: unknown, source: AutocompleteSource) => void;
+    /** Tab accepts the highlighted item, as Enter does. Default `true`. */
+    acceptOnTab?: boolean;
+    /** Base for the generated `id`s the ARIA wiring points at. */
+    id?: string;
+}
+export interface AutocompleteInputProps {
+    ref: (element: HTMLTextAreaElement | HTMLInputElement | null) => void;
+    onChange: (event: React.ChangeEvent<HTMLTextAreaElement | HTMLInputElement>) => void;
+    onKeyDown: (event: React.KeyboardEvent<HTMLTextAreaElement | HTMLInputElement>) => void;
+    onSelect: (event: React.SyntheticEvent<HTMLTextAreaElement | HTMLInputElement>) => void;
+    onClick: (event: React.MouseEvent<HTMLTextAreaElement | HTMLInputElement>) => void;
+    role: 'combobox';
+    'aria-expanded': boolean;
+    'aria-autocomplete': 'list';
+    'aria-haspopup': 'listbox';
+    'aria-controls'?: string;
+    'aria-activedescendant'?: string;
+}
+export interface AutocompleteListboxProps {
+    id: string;
+    role: 'listbox';
+    'aria-label': string;
+}
+export interface AutocompleteOptionProps {
+    id: string;
+    role: 'option';
+    'aria-selected': boolean;
+}
+export interface ComposerAutocomplete {
+    isOpen: boolean;
+    /** The source behind the open menu, so a renderer can group or label by it. */
+    source: AutocompleteSource | null;
+    trigger: string | null;
+    /** The text between the trigger and the caret. */
+    query: string;
+    items: AutocompleteItem[];
+    activeIndex: number;
+    activeItem: AutocompleteItem | null;
+    /** An async source has been asked and has not answered yet. */
+    isLoading: boolean;
+    /** The message from a source that threw. The menu stays open and empty. */
+    error: string | null;
+    highlight: (index: number) => void;
+    /** Wraps at both ends, so ↓ from the last item lands on the first. */
+    moveHighlight: (delta: number) => void;
+    /** Insert an item — the highlighted one by default. A click handler calls this directly. */
+    accept: (item?: AutocompleteItem) => void;
+    /** Close for the token being typed, without touching the text. */
+    dismiss: () => void;
+    getInputProps: () => AutocompleteInputProps;
+    getListboxProps: () => AutocompleteListboxProps;
+    getOptionProps: (index: number) => AutocompleteOptionProps;
+}
+/**
+ * The state machine behind a `/`-style autocomplete in a chat composer: which trigger the caret is
+ * inside, what the query is, which items answer it, which one is highlighted, and what accepting
+ * one does to the text and the caret. It renders nothing and knows nothing about skills, agents or
+ * threads — a host supplies sources, and the same machine drives `@` as drives `/`.
+ *
+ * The keys the open menu owns (↑ ↓ Enter Tab Escape) are consumed with `preventDefault`, which is
+ * how a composer that sends on Enter knows to stand down: call this handler first and return early
+ * when the event comes back `defaultPrevented`.
+ */
+export declare function useComposerAutocomplete(options: UseComposerAutocompleteOptions): ComposerAutocomplete;
+//# sourceMappingURL=use-composer-autocomplete.d.ts.map

package/dist/src/react/core/composer/use-composer-autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-composer-autocomplete.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/composer/use-composer-autocomplete.ts"],"names":[],"mappings":"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"}

package/dist/src/react/core/composer/use-composer-autocomplete.js

@@ -0,0 +1,244 @@
+import { useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from 'react';
+import { applyCompletion, filterAutocompleteItems, findActiveTrigger, } from './model.js';
+/**
+ * The state machine behind a `/`-style autocomplete in a chat composer: which trigger the caret is
+ * inside, what the query is, which items answer it, which one is highlighted, and what accepting
+ * one does to the text and the caret. It renders nothing and knows nothing about skills, agents or
+ * threads — a host supplies sources, and the same machine drives `@` as drives `/`.
+ *
+ * The keys the open menu owns (↑ ↓ Enter Tab Escape) are consumed with `preventDefault`, which is
+ * how a composer that sends on Enter knows to stand down: call this handler first and return early
+ * when the event comes back `defaultPrevented`.
+ */
+export function useComposerAutocomplete(options) {
+    const { value, sources, acceptOnTab = true } = options;
+    const latest = useRef(options);
+    latest.current = options;
+    const inputRef = useRef(null);
+    const [caret, setCaret] = useState(value.length);
+    const [items, setItems] = useState([]);
+    const [isLoading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [activeIndex, setActiveIndex] = useState(0);
+    // The trigger index Escape closed. Cleared the moment the caret leaves that token, so deleting
+    // the trigger and typing it again offers the menu rather than staying silently dismissed.
+    const [dismissedIndex, setDismissedIndex] = useState(null);
+    // Clamped: a host that resets the draft externally leaves the caret past the end of the text.
+    const safeCaret = Math.min(caret, value.length);
+    const match = useMemo(() => findActiveTrigger(value, safeCaret, sources), [value, safeCaret, sources]);
+    const isActive = match !== null && dismissedIndex !== match.index;
+    const matchRef = useRef(match);
+    matchRef.current = match;
+    const caretRef = useRef(safeCaret);
+    caretRef.current = safeCaret;
+    const itemsRef = useRef(items);
+    itemsRef.current = items;
+    const activeIndexRef = useRef(activeIndex);
+    activeIndexRef.current = activeIndex;
+    // Identifies the question being asked, so a re-render that changes neither the source nor the
+    // query does not re-ask — an async source would otherwise fetch on every unrelated render. The
+    // NUL separator cannot appear in either half, so no pair of them collides.
+    const requestKey = isActive && match ? `${match.source.id}\u0000${match.query}` : null;
+    useEffect(() => {
+        const current = matchRef.current;
+        if (requestKey === null || current === null) {
+            setItems([]);
+            setLoading(false);
+            setError(null);
+            return;
+        }
+        const { source, query } = current;
+        const controller = new AbortController();
+        // The cleanup below runs before the next query's effect, so a slow answer to an abandoned
+        // query finds `superseded` already true and is dropped instead of overwriting a newer list.
+        let superseded = false;
+        const settle = (next) => {
+            if (superseded)
+                return;
+            setItems((source.filter ?? filterAutocompleteItems)(next, query));
+            setActiveIndex(0);
+            setLoading(false);
+            setError(null);
+        };
+        const failed = (cause) => {
+            if (superseded)
+                return;
+            setItems([]);
+            setLoading(false);
+            setError(cause instanceof Error ? cause.message : 'Could not load suggestions');
+            latest.current.onError?.(cause, source);
+        };
+        let result;
+        try {
+            result = source.getItems(query, controller.signal);
+        }
+        catch (cause) {
+            failed(cause);
+            return;
+        }
+        // A static source answers in the same tick: settling synchronously spares the list a frame of
+        // emptiness between the trigger being typed and its items appearing.
+        if (!isPromise(result)) {
+            settle(result);
+            return;
+        }
+        setLoading(true);
+        setError(null);
+        result.then(settle, failed);
+        return () => {
+            superseded = true;
+            controller.abort();
+        };
+    }, [requestKey]);
+    // Open the moment the caret is inside a live trigger token, before any items are in: an empty
+    // menu that says "no matches" is an answer, whereas a menu that never appears reads as broken.
+    // The keys the menu owns are still only taken when there is something to take them for.
+    const isOpen = isActive;
+    const activeItem = isOpen ? (items[activeIndex] ?? null) : null;
+    const reactId = useId();
+    const listboxId = options.id ?? `agent-autocomplete-${reactId}`;
+    const optionId = useCallback((index) => `${listboxId}-option-${index}`, [listboxId]);
+    const highlight = useCallback((index) => {
+        const total = itemsRef.current.length;
+        if (total === 0)
+            return;
+        setActiveIndex(((index % total) + total) % total);
+    }, []);
+    const moveHighlight = useCallback((delta) => highlight(activeIndexRef.current + delta), [highlight]);
+    const dismiss = useCallback(() => {
+        const current = matchRef.current;
+        if (current)
+            setDismissedIndex(current.index);
+    }, []);
+    // Set after an accept and consumed on the next commit: the textarea is controlled, so React
+    // writes the new value only once this render lands and any caret set before that is overwritten.
+    const pendingCaret = useRef(null);
+    const accept = useCallback((item) => {
+        const current = matchRef.current;
+        if (!current)
+            return;
+        const chosen = item ?? itemsRef.current[activeIndexRef.current];
+        if (!chosen)
+            return;
+        const edit = applyCompletion(latest.current.value, caretRef.current, current, chosen);
+        latest.current.onValueChange(edit.text);
+        setCaret(edit.caret);
+        setDismissedIndex(null);
+        pendingCaret.current = edit.caret;
+    }, []);
+    useLayoutEffect(() => {
+        const position = pendingCaret.current;
+        if (position === null)
+            return;
+        pendingCaret.current = null;
+        inputRef.current?.setSelectionRange(position, position);
+    });
+    const readCaret = useCallback((element) => {
+        setCaret(element.selectionStart ?? element.value.length);
+    }, []);
+    const onKeyDown = useCallback((event) => {
+        if (!isOpen)
+            return;
+        const hasItems = itemsRef.current.length > 0;
+        switch (event.key) {
+            case 'ArrowDown':
+                if (!hasItems)
+                    return;
+                event.preventDefault();
+                moveHighlight(1);
+                return;
+            case 'ArrowUp':
+                if (!hasItems)
+                    return;
+                event.preventDefault();
+                moveHighlight(-1);
+                return;
+            case 'Enter':
+                if (!hasItems)
+                    return;
+                event.preventDefault();
+                accept();
+                return;
+            case 'Tab':
+                // Shift+Tab stays a backwards focus move: a completion menu is not a focus trap.
+                if (!acceptOnTab || event.shiftKey || !hasItems)
+                    return;
+                event.preventDefault();
+                accept();
+                return;
+            case 'Escape':
+                event.preventDefault();
+                dismiss();
+                return;
+            default:
+                return;
+        }
+    }, [isOpen, acceptOnTab, accept, dismiss, moveHighlight]);
+    const onChange = useCallback((event) => {
+        readCaret(event.target);
+        // A token the user has walked away from is no longer dismissed — it is gone.
+        const next = findActiveTrigger(event.target.value, event.target.selectionStart ?? event.target.value.length, latest.current.sources);
+        setDismissedIndex((current) => current !== null && next?.index === current ? current : null);
+    }, [readCaret]);
+    const onSelect = useCallback((event) => readCaret(event.currentTarget), [readCaret]);
+    const onClick = useCallback((event) => readCaret(event.currentTarget), [readCaret]);
+    const setInput = useCallback((element) => {
+        inputRef.current = element;
+    }, []);
+    const getInputProps = useCallback(() => ({
+        ref: setInput,
+        onChange,
+        onKeyDown,
+        onSelect,
+        onClick,
+        role: 'combobox',
+        'aria-expanded': isOpen,
+        'aria-autocomplete': 'list',
+        'aria-haspopup': 'listbox',
+        ...(isOpen ? { 'aria-controls': listboxId } : {}),
+        ...(activeItem ? { 'aria-activedescendant': optionId(activeIndex) } : {}),
+    }), [
+        setInput,
+        onChange,
+        onKeyDown,
+        onSelect,
+        onClick,
+        isOpen,
+        listboxId,
+        activeItem,
+        activeIndex,
+        optionId,
+    ]);
+    const getListboxProps = useCallback(() => ({
+        id: listboxId,
+        role: 'listbox',
+        'aria-label': match?.source.label ?? match?.source.id ?? 'Suggestions',
+    }), [listboxId, match]);
+    const getOptionProps = useCallback((index) => ({
+        id: optionId(index),
+        role: 'option',
+        'aria-selected': index === activeIndex,
+    }), [optionId, activeIndex]);
+    return {
+        isOpen,
+        source: isOpen && match ? match.source : null,
+        trigger: isOpen && match ? match.source.trigger : null,
+        query: match?.query ?? '',
+        items,
+        activeIndex,
+        activeItem,
+        isLoading,
+        error,
+        highlight,
+        moveHighlight,
+        accept,
+        dismiss,
+        getInputProps,
+        getListboxProps,
+        getOptionProps,
+    };
+}
+function isPromise(value) {
+    return typeof value.then === 'function';
+}
+//# sourceMappingURL=use-composer-autocomplete.js.map

package/dist/src/react/core/composer/use-composer-autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-composer-autocomplete.js","sourceRoot":"","sources":["../../../../../src/react/core/composer/use-composer-autocomplete.ts"],"names":[],"mappings":"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"}

package/dist/src/react/core/config/use-agent-config.d.ts

@@ -0,0 +1,21 @@
+import type { AgentClientConfig } from '../../../index.js';
+import type { AgentBackend } from '../backend.js';
+export interface UseAgentConfigOptions {
+    /** Default: the enclosing `<AgentProvider>`'s. Without `getConfig` the config stays `undefined`. */
+    backend?: AgentBackend;
+    /** `false` holds the request. Default `true`. */
+    enabled?: boolean;
+}
+export interface AgentConfigState {
+    /** `GET <base>/config`, once loaded — `undefined` before, on a failure, or on a backend without it. */
+    config: AgentClientConfig | undefined;
+    isLoading: boolean;
+    error: Error | null;
+}
+/**
+ * The server's client config (`GET <base>/config`): attachment limits and upload mode, and whether a
+ * model picker, a quota and anonymous identities are in play. Fetched once per backend and shared;
+ * `useAttachments` takes its defaults from it.
+ */
+export declare function useAgentConfig(options?: UseAgentConfigOptions): AgentConfigState;
+//# sourceMappingURL=use-agent-config.d.ts.map

package/dist/src/react/core/config/use-agent-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-agent-config.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/config/use-agent-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,WAAW,qBAAqB;IACpC,oGAAoG;IACpG,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uGAAuG;IACvG,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAoBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,gBAAgB,CAgCpF"}