@handsforbots/menu 0.0.0-stage → 2.0.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE.md ADDED
@@ -0,0 +1,9 @@
1
+ The MIT License (MIT)
2
+
3
+ Copyright © 2024 Alex Lana and Hands for Bots contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
6
+
7
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
8
+
9
+ THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,21 @@
1
- # Temporary Holding Version
1
+ # @handsforbots/menu
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Plugin. Direct commands (no LLM) for Hands for Bots: slash, patterns and fuzzy phrases.
4
+
5
+ Part of [Hands for Bots](https://github.com/handsforbots/handsforbots), a headless multimodal and action layer between users, GUIs and agents.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ npm install @handsforbots/menu@alpha @handsforbots/core@alpha
11
+ ```
12
+
13
+ ## Documentation
14
+
15
+ - [This package](https://github.com/handsforbots/handsforbots/blob/main/docs/en-us/plugins.md#menu)
16
+ - [Getting started](https://github.com/handsforbots/handsforbots/blob/main/docs/en-us/getting-started.md)
17
+ - [Documentação em português](https://github.com/handsforbots/handsforbots/blob/main/docs/pt-br/README.md)
18
+
19
+ ## License
20
+
21
+ MIT
@@ -0,0 +1,33 @@
1
+ /** Lowercase, strip accents and punctuation, collapse spaces. */
2
+ export declare function normalize(text: string): string;
3
+ /** Optimal string alignment distance (Levenshtein + adjacent transpositions). */
4
+ export declare function distance(a: string, b: string): number;
5
+ /** 0..1 similarity between two texts after normalization. */
6
+ export declare function similarity(a: string, b: string): number;
7
+ export type FuzzyEntry<T> = {
8
+ phrase: string;
9
+ value: T;
10
+ };
11
+ export type FuzzyResult<T> = {
12
+ value: T;
13
+ phrase: string;
14
+ score: number;
15
+ };
16
+ export type FuzzyOptions = {
17
+ /** Minimum similarity (0..1). Default 0.8. */
18
+ threshold?: number;
19
+ /** Inputs with more words are not short commands; they go to the LLM. Default 6. */
20
+ maxWords?: number;
21
+ };
22
+ /**
23
+ * Best phrase for a short input, or undefined. Tolerates typos and speech
24
+ * transcription slips ("porximo" → "próximo"), not paraphrases: that is the
25
+ * job of a semantic matcher.
26
+ */
27
+ export declare function fuzzyBest<T>(input: string, entries: FuzzyEntry<T>[], options?: FuzzyOptions): FuzzyResult<T> | undefined;
28
+ /**
29
+ * Every distinct value with its best-scoring phrase, highest score first,
30
+ * with no threshold. Empty for empty or long inputs (`maxWords`).
31
+ */
32
+ export declare function fuzzyRank<T>(input: string, entries: FuzzyEntry<T>[], options?: Pick<FuzzyOptions, 'maxWords'>): FuzzyResult<T>[];
33
+ //# sourceMappingURL=fuzzy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fuzzy.d.ts","sourceRoot":"","sources":["../src/fuzzy.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBrD;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAA;AACxD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAExE,MAAM,MAAM,YAAY,GAAG;IACzB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAG5H;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAM,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAUpI"}
package/dist/fuzzy.js ADDED
@@ -0,0 +1,69 @@
1
+ /** Lowercase, strip accents and punctuation, collapse spaces. */
2
+ export function normalize(text) {
3
+ return text
4
+ .normalize('NFD')
5
+ .replace(/[̀-ͯ]/g, '')
6
+ .toLowerCase()
7
+ .replace(/[^\p{L}\p{N}\s/]/gu, ' ')
8
+ .replace(/\s+/g, ' ')
9
+ .trim();
10
+ }
11
+ /** Optimal string alignment distance (Levenshtein + adjacent transpositions). */
12
+ export function distance(a, b) {
13
+ if (a === b)
14
+ return 0;
15
+ if (!a.length)
16
+ return b.length;
17
+ if (!b.length)
18
+ return a.length;
19
+ let prevPrev = [];
20
+ let prev = Array.from({ length: b.length + 1 }, (_, j) => j);
21
+ for (let i = 1; i <= a.length; i++) {
22
+ const row = [i];
23
+ for (let j = 1; j <= b.length; j++) {
24
+ const cost = a[i - 1] === b[j - 1] ? 0 : 1;
25
+ let value = Math.min(prev[j] + 1, row[j - 1] + 1, prev[j - 1] + cost);
26
+ if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
27
+ value = Math.min(value, prevPrev[j - 2] + 1);
28
+ }
29
+ row.push(value);
30
+ }
31
+ prevPrev = prev;
32
+ prev = row;
33
+ }
34
+ return prev[b.length];
35
+ }
36
+ /** 0..1 similarity between two texts after normalization. */
37
+ export function similarity(a, b) {
38
+ const x = normalize(a);
39
+ const y = normalize(b);
40
+ const longest = Math.max(x.length, y.length);
41
+ return longest === 0 ? 1 : 1 - distance(x, y) / longest;
42
+ }
43
+ /**
44
+ * Best phrase for a short input, or undefined. Tolerates typos and speech
45
+ * transcription slips ("porximo" → "próximo"), not paraphrases: that is the
46
+ * job of a semantic matcher.
47
+ */
48
+ export function fuzzyBest(input, entries, options = {}) {
49
+ const best = fuzzyRank(input, entries, options)[0];
50
+ return best && best.score >= (options.threshold ?? 0.8) ? best : undefined;
51
+ }
52
+ /**
53
+ * Every distinct value with its best-scoring phrase, highest score first,
54
+ * with no threshold. Empty for empty or long inputs (`maxWords`).
55
+ */
56
+ export function fuzzyRank(input, entries, options = {}) {
57
+ const text = normalize(input);
58
+ if (!text || text.split(' ').length > (options.maxWords ?? 6))
59
+ return [];
60
+ const best = new Map();
61
+ for (const entry of entries) {
62
+ const score = similarity(text, entry.phrase);
63
+ const current = best.get(entry.value);
64
+ if (!current || score > current.score)
65
+ best.set(entry.value, { value: entry.value, phrase: entry.phrase, score });
66
+ }
67
+ return [...best.values()].sort((a, b) => b.score - a.score);
68
+ }
69
+ //# sourceMappingURL=fuzzy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fuzzy.js","sourceRoot":"","sources":["../src/fuzzy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,90 @@
1
+ import { type Match, type Signal } from '@handsforbots/core';
2
+ export { distance, fuzzyBest, fuzzyRank, normalize, similarity, type FuzzyEntry, type FuzzyOptions, type FuzzyResult } from './fuzzy.js';
3
+ export type CommandArgs = unknown | ((captured: Record<string, string>) => unknown);
4
+ export type Command = {
5
+ /** Registered action this command runs. */
6
+ action: string;
7
+ /** Label for palettes and suggestions. */
8
+ label?: string;
9
+ /** `/name` triggers; the rest of the line is captured as `rest`. */
10
+ slash?: string | string[];
11
+ /**
12
+ * Full-sentence patterns. Strings use `{name}` placeholders
13
+ * ("mostrar pedidos {status}"); RegExps use named groups.
14
+ */
15
+ patterns?: (string | RegExp)[];
16
+ /** Short phrases matched with typo tolerance, optionally per language. */
17
+ phrases?: string[] | Record<string, string[]>;
18
+ /** Static args, or built from captured placeholders / `rest`. */
19
+ args?: CommandArgs;
20
+ /** Confirmation shown (and spoken) after the action runs. */
21
+ reply?: (result: unknown, args: unknown) => string | undefined;
22
+ };
23
+ export type MenuOptions = {
24
+ commands?: Command[];
25
+ /** Picks per-language phrases, e.g. 'pt-br' (falls back to 'pt', then all). */
26
+ language?: string;
27
+ /** Minimum fuzzy similarity. Default 0.8. */
28
+ fuzzyThreshold?: number;
29
+ /** Longer inputs skip fuzzy matching. Default 6 words. */
30
+ maxFuzzyWords?: number;
31
+ /**
32
+ * The best command must beat the runner-up (a different command) by this
33
+ * much; otherwise the input is uncertain. Default 0.05.
34
+ */
35
+ fuzzyMargin?: number;
36
+ /**
37
+ * What to do with uncertain inputs: a fuzzy score between `askThreshold`
38
+ * and `fuzzyThreshold`, or two commands within `fuzzyMargin`.
39
+ * `'llm'` (default) sends them to the transport; `'ask'` replies
40
+ * "did you mean…?" with the candidates as quick replies, without the LLM.
41
+ */
42
+ uncertain?: 'llm' | 'ask';
43
+ /** Lowest fuzzy score that still asks (with `uncertain: 'ask'`). Default 0.6. */
44
+ askThreshold?: number;
45
+ /** Text of the "did you mean…?" reply. Default per `language` (pt, es, en). */
46
+ askText?: (phrases: string[]) => string;
47
+ /**
48
+ * Words that make a short input a non-command ("não abrir detalhes"): when
49
+ * the input has one that the matched phrase lacks, fuzzy matching skips it.
50
+ * Default per `language` (pt, es, en; all of them without a language).
51
+ */
52
+ negations?: string[];
53
+ /**
54
+ * Typed text ending in "?" ("fechar modal?") is a question, not a command:
55
+ * `'llm'` (default) skips fuzzy matching for it; `'command'` matches it.
56
+ * Transcripts are never affected (recognizers add "?" on their own).
57
+ */
58
+ typedQuestions?: 'llm' | 'command';
59
+ };
60
+ /** Action the menu runs to ask "did you mean…?" for uncertain inputs. */
61
+ export declare const CLARIFY_ACTION = "menu.clarify";
62
+ export type Suggestion = {
63
+ command: Command;
64
+ label: string;
65
+ score: number;
66
+ };
67
+ export type MenuService = {
68
+ add(command: Command): () => void;
69
+ list(): Command[];
70
+ /** Ranked commands for what the user is typing or saying (palettes, autocomplete). */
71
+ suggest(text: string, limit?: number): Suggestion[];
72
+ /**
73
+ * Builds a signal that runs a command explicitly (buttons, palette, quick
74
+ * replies). The label is kept as text so history reads naturally.
75
+ */
76
+ commandSignal(action: string, args?: unknown, label?: string): Omit<Signal, 'id' | 'timestamp'>;
77
+ };
78
+ declare module '@handsforbots/core' {
79
+ interface Services {
80
+ menu: MenuService;
81
+ }
82
+ }
83
+ export declare const menu: (config?: MenuOptions | undefined) => import("@handsforbots/core").Plugin<MenuOptions | undefined>;
84
+ export declare function createMenu(options?: MenuOptions): {
85
+ api: MenuService;
86
+ matchExplicit: (signal: Signal) => Match | null;
87
+ matchPattern: (signal: Signal) => Match | null;
88
+ matchFuzzy: (signal: Signal) => Match | null;
89
+ };
90
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js ADDED
@@ -0,0 +1,209 @@
1
+ import { definePlugin, textOf } from '@handsforbots/core';
2
+ import { fuzzyRank, normalize, similarity } from './fuzzy.js';
3
+ export { distance, fuzzyBest, fuzzyRank, normalize, similarity } from './fuzzy.js';
4
+ /** Action the menu runs to ask "did you mean…?" for uncertain inputs. */
5
+ export const CLARIFY_ACTION = 'menu.clarify';
6
+ const NEGATIONS = {
7
+ pt: ['não', 'nunca', 'jamais', 'nem'],
8
+ es: ['no', 'nunca', 'jamás', 'ni'],
9
+ en: ['not', 'never', "don't", 'dont', "doesn't", "didn't", "won't", 'no'],
10
+ };
11
+ const ASK_TEXT = {
12
+ pt: (list) => `Você quis dizer ${list}?`,
13
+ es: (list) => `¿Quisiste decir ${list}?`,
14
+ en: (list) => `Did you mean ${list}?`,
15
+ };
16
+ const OR = { pt: 'ou', es: 'o', en: 'or' };
17
+ export const menu = definePlugin({
18
+ name: 'menu',
19
+ provides: ['menu'],
20
+ apply(ctx, options = {}) {
21
+ const service = createMenu(options);
22
+ ctx.provide('menu', service.api);
23
+ ctx.addMatcher({ name: 'menu.explicit', priority: -30, match: service.matchExplicit });
24
+ ctx.addMatcher({ name: 'menu.pattern', priority: -20, match: service.matchPattern });
25
+ ctx.addMatcher({ name: 'menu.fuzzy', priority: -10, match: service.matchFuzzy });
26
+ if (options.uncertain === 'ask') {
27
+ ctx.registerAction({
28
+ name: CLARIFY_ACTION,
29
+ description: 'Asks the user which command they meant.',
30
+ confirm: 'never',
31
+ exposeTo: ['user'],
32
+ handler: (args) => args,
33
+ });
34
+ }
35
+ },
36
+ });
37
+ export function createMenu(options = {}) {
38
+ let commands = [...(options.commands ?? [])];
39
+ const phrasesOf = (command) => {
40
+ if (!command.phrases)
41
+ return [];
42
+ if (Array.isArray(command.phrases))
43
+ return command.phrases;
44
+ const language = options.language?.toLowerCase();
45
+ const byLanguage = command.phrases;
46
+ if (language && byLanguage[language])
47
+ return byLanguage[language];
48
+ const base = language?.split('-')[0];
49
+ if (base && byLanguage[base])
50
+ return byLanguage[base];
51
+ return Object.values(byLanguage).flat();
52
+ };
53
+ const slashesOf = (command) => (Array.isArray(command.slash) ? command.slash : command.slash ? [command.slash] : []).map((s) => normalize(s.replace(/^\//, '')));
54
+ const base = options.language?.toLowerCase().split('-')[0];
55
+ const negationWords = (options.negations ?? (base && NEGATIONS[base] ? NEGATIONS[base] : [
56
+ ...new Set(Object.values(NEGATIONS).flat().filter((w) => w !== 'no')),
57
+ ])).map(normalize).filter(Boolean);
58
+ const padded = (text) => ` ${normalize(text)} `;
59
+ /** A negation in the input that the phrase does not have ("não abrir" vs "abrir"). */
60
+ const negates = (input, phrase) => negationWords.some((word) => padded(input).includes(` ${word} `) && !padded(phrase).includes(` ${word} `));
61
+ const askText = (phrases) => {
62
+ if (options.askText)
63
+ return options.askText(phrases);
64
+ const lang = base && ASK_TEXT[base] ? base : 'en';
65
+ const quoted = phrases.map((p) => `"${p}"`);
66
+ const list = quoted.length > 1 ? `${quoted.slice(0, -1).join(', ')} ${OR[lang]} ${quoted.at(-1)}` : quoted[0];
67
+ return ASK_TEXT[lang](list);
68
+ };
69
+ const resolveArgs = (command, captured) => typeof command.args === 'function' ? command.args(captured) : (command.args ?? captured);
70
+ const toMatch = (command, captured, confidence) => {
71
+ const args = resolveArgs(command, captured);
72
+ return {
73
+ action: command.action,
74
+ args,
75
+ confidence,
76
+ reply: command.reply ? (result) => command.reply(result, args) : undefined,
77
+ };
78
+ };
79
+ const textInput = (signal) => signal.modality === 'text' || signal.modality === 'transcript' ? textOf(signal.parts).trim() : undefined;
80
+ const matchExplicit = (signal) => {
81
+ if (signal.modality === 'command') {
82
+ const data = signal.parts.find((p) => p.type === 'data' && p.name === 'command');
83
+ if (data?.type !== 'data')
84
+ return null;
85
+ const { action, args } = data.value;
86
+ const command = commands.find((c) => c.action === action);
87
+ return { action, args: args ?? {}, confidence: 1, reply: command?.reply && ((r) => command.reply(r, args)) };
88
+ }
89
+ const text = textInput(signal);
90
+ if (!text?.startsWith('/'))
91
+ return null;
92
+ const [head = '', ...rest] = text.slice(1).split(/\s+/);
93
+ const name = normalize(head);
94
+ const command = commands.find((c) => slashesOf(c).includes(name));
95
+ return command ? toMatch(command, { rest: rest.join(' ') }, 1) : null;
96
+ };
97
+ const compiled = new WeakMap();
98
+ const patternsOf = (command) => {
99
+ let list = compiled.get(command);
100
+ if (!list) {
101
+ list = (command.patterns ?? []).map((p) => typeof p === 'string' ? { regexp: templateToRegExp(p), template: true } : { regexp: p, template: false });
102
+ compiled.set(command, list);
103
+ }
104
+ return list;
105
+ };
106
+ const matchPattern = (signal) => {
107
+ const text = textInput(signal);
108
+ if (!text)
109
+ return null;
110
+ const normalized = normalize(text);
111
+ for (const command of commands) {
112
+ for (const { regexp, template } of patternsOf(command)) {
113
+ // Templates match normalized text (case/accent-insensitive, so captures are normalized too).
114
+ const found = template ? regexp.exec(normalized) : (regexp.exec(text) ?? regexp.exec(normalized));
115
+ if (found)
116
+ return toMatch(command, { ...found.groups }, 1);
117
+ }
118
+ }
119
+ return null;
120
+ };
121
+ const matchFuzzy = (signal) => {
122
+ const text = textInput(signal);
123
+ if (!text || text.startsWith('/'))
124
+ return null;
125
+ if (signal.modality === 'text' && text.endsWith('?') && options.typedQuestions !== 'command')
126
+ return null;
127
+ const entries = commands.flatMap((command) => phrasesOf(command).map((phrase) => ({ phrase, value: command })));
128
+ const ranked = fuzzyRank(text, entries, { maxWords: options.maxFuzzyWords }).filter((r) => !negates(text, r.phrase));
129
+ const [best, second] = ranked;
130
+ if (!best)
131
+ return null;
132
+ const threshold = options.fuzzyThreshold ?? 0.8;
133
+ const close = second !== undefined && best.score - second.score < (options.fuzzyMargin ?? 0.05);
134
+ if (best.score >= threshold && !close)
135
+ return toMatch(best.value, {}, best.score);
136
+ if (options.uncertain !== 'ask')
137
+ return null;
138
+ const askFrom = Math.min(options.askThreshold ?? 0.6, threshold);
139
+ const candidates = ranked.filter((r) => r.score >= askFrom && best.score - r.score < 0.2).slice(0, 3);
140
+ return candidates.length ? clarify(candidates) : null;
141
+ };
142
+ /** "Did you mean…?" reply; each quick reply is a phrase, so choosing it (or saying it) matches exactly. */
143
+ const clarify = (candidates) => {
144
+ const choices = candidates.map((c) => ({ action: c.value.action, phrase: c.phrase, score: c.score }));
145
+ const phrases = candidates.map((c) => c.phrase);
146
+ return {
147
+ action: CLARIFY_ACTION,
148
+ args: { options: choices },
149
+ confidence: 1,
150
+ reply: () => askText(phrases),
151
+ parts: [{ type: 'data', name: 'quick_replies', value: phrases.map((label) => ({ label })) }],
152
+ };
153
+ };
154
+ const api = {
155
+ add(command) {
156
+ commands = [...commands, command];
157
+ return () => {
158
+ commands = commands.filter((c) => c !== command);
159
+ };
160
+ },
161
+ list: () => commands,
162
+ suggest(input, limit = 5) {
163
+ const text = normalize(input.replace(/^\//, ''));
164
+ const scored = [];
165
+ for (const command of commands) {
166
+ const candidates = [...slashesOf(command), ...phrasesOf(command).map(normalize), normalize(command.label ?? '')].filter(Boolean);
167
+ let score = 0;
168
+ for (const candidate of candidates) {
169
+ if (!text)
170
+ score = Math.max(score, 0.1);
171
+ else if (candidate.startsWith(text))
172
+ score = Math.max(score, 0.9 + text.length / candidate.length / 10);
173
+ else if (candidate.includes(text))
174
+ score = Math.max(score, 0.7);
175
+ else
176
+ score = Math.max(score, similarity(text, candidate.slice(0, Math.max(text.length, 1))) * 0.8);
177
+ }
178
+ if (score >= 0.5 || !text) {
179
+ scored.push({ command, label: command.label ?? phrasesOf(command)[0] ?? `/${slashesOf(command)[0] ?? command.action}`, score });
180
+ }
181
+ }
182
+ return scored.sort((a, b) => b.score - a.score).slice(0, limit);
183
+ },
184
+ commandSignal: (action, args, label) => ({
185
+ kind: 'trigger',
186
+ modality: 'command',
187
+ source: 'menu',
188
+ parts: [
189
+ ...(label ? [{ type: 'text', text: label }] : []),
190
+ { type: 'data', name: 'command', value: { action, args } },
191
+ ],
192
+ }),
193
+ };
194
+ return { api, matchExplicit, matchPattern, matchFuzzy };
195
+ }
196
+ /** "mostrar pedidos {status}" → /^mostrar pedidos (?<status>.+?)$/ over normalized text. */
197
+ function templateToRegExp(template) {
198
+ const names = [];
199
+ const marked = template.replace(/\{(\w+)\}/g, (_, name) => ` h4bslot${names.push(name) - 1} `);
200
+ const source = normalize(marked)
201
+ .split(' ')
202
+ .map((token) => {
203
+ const slot = /^h4bslot(\d+)$/.exec(token);
204
+ return slot ? `(?<${names[Number(slot[1])]}>.+?)` : token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
205
+ })
206
+ .join(' ');
207
+ return new RegExp(`^${source}$`, 'u');
208
+ }
209
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,44 @@
1
1
  {
2
2
  "name": "@handsforbots/menu",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "2.0.0-alpha.1",
4
+ "description": "Plugin. Direct commands (no LLM) for Hands for Bots: slash, patterns and fuzzy phrases.",
5
+ "keywords": [
6
+ "handsforbots",
7
+ "h4b",
8
+ "h4b-plugin"
9
+ ],
10
+ "license": "MIT",
11
+ "homepage": "https://github.com/handsforbots/handsforbots/blob/main/docs/en-us/plugins.md#menu",
12
+ "repository": {
13
+ "type": "git",
14
+ "url": "git+https://github.com/handsforbots/handsforbots.git",
15
+ "directory": "packages/menu"
16
+ },
17
+ "bugs": {
18
+ "url": "https://github.com/handsforbots/handsforbots/issues"
19
+ },
20
+ "type": "module",
21
+ "sideEffects": false,
22
+ "exports": {
23
+ ".": {
24
+ "types": "./dist/index.d.ts",
25
+ "import": "./dist/index.js"
26
+ }
27
+ },
28
+ "publishConfig": {
29
+ "access": "public"
30
+ },
31
+ "files": [
32
+ "dist"
33
+ ],
34
+ "peerDependencies": {
35
+ "@handsforbots/core": "^2.0.0-alpha.1"
36
+ },
37
+ "devDependencies": {
38
+ "@handsforbots/core": "^2.0.0-alpha.1"
39
+ },
40
+ "scripts": {
41
+ "build": "tsc -p tsconfig.build.json",
42
+ "typecheck": "tsc -p tsconfig.json --noEmit"
43
+ }
6
44
  }