@handsforbots/cues 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 +9 -0
- package/README.md +20 -2
- package/dist/index.d.ts +155 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +583 -0
- package/dist/index.js.map +1 -0
- package/dist/server.d.ts +52 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +96 -0
- package/dist/server.js.map +1 -0
- package/package.json +49 -3
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
|
-
#
|
|
1
|
+
# @handsforbots/cues
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Plugin. Cues for Hands for Bots: closed-vocabulary presentation categories (tone, scene, urgency…) set by the backend, an action or content rules, with repetition counts and policies.
|
|
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/cues@alpha @handsforbots/core@alpha
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Documentation
|
|
14
|
+
|
|
15
|
+
- [This package](https://github.com/handsforbots/handsforbots/blob/main/docs/en-us/plugins.md#cues)
|
|
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
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
import { type AssistantMessage, type Modality, type Signal, type SourcePart } from '@handsforbots/core';
|
|
2
|
+
/** What happens when a value repeats (ADR 0018). */
|
|
3
|
+
export type RepeatPolicy = {
|
|
4
|
+
/** What `levels` and `max` count: messages in a row with the value (default) or all of them in the conversation. */
|
|
5
|
+
by?: 'streak' | 'count';
|
|
6
|
+
/** Thresholds that raise the level, ascending: `[2, 4]` → level 2 from the 2nd, level 3 from the 4th. */
|
|
7
|
+
levels?: number[];
|
|
8
|
+
/** How many times the value may apply; past it, the value becomes `then`. */
|
|
9
|
+
max?: number;
|
|
10
|
+
/** Value used past `max` (same channel). Default: the channel's `default`. */
|
|
11
|
+
then?: string;
|
|
12
|
+
};
|
|
13
|
+
/** A presentation dimension with a closed vocabulary (tone, scene, urgency…). */
|
|
14
|
+
export type CueChannel = {
|
|
15
|
+
/** Accepted values, as codes (`[A-Za-z0-9_.:-]{1,64}`). */
|
|
16
|
+
values: readonly string[];
|
|
17
|
+
/** Value when nobody decided. Must be in `values`. */
|
|
18
|
+
default: string;
|
|
19
|
+
/** `'message'` (default): a message without a value goes back to `default`. `'sticky'`: keeps the previous value. */
|
|
20
|
+
persist?: 'message' | 'sticky';
|
|
21
|
+
/** Repetition policy per value. */
|
|
22
|
+
repeat?: Record<string, RepeatPolicy>;
|
|
23
|
+
/** What the channel means, for the `set_cues` action's JSON Schema. */
|
|
24
|
+
description?: string;
|
|
25
|
+
};
|
|
26
|
+
/** What a rule sees when an assistant message ends. */
|
|
27
|
+
export type CueRuleContext = {
|
|
28
|
+
message: AssistantMessage;
|
|
29
|
+
/** The message's text. */
|
|
30
|
+
text: string;
|
|
31
|
+
sources: SourcePart[];
|
|
32
|
+
/** Everything `classify` returned for the message's sources. */
|
|
33
|
+
taxonomies: ReadonlySet<string>;
|
|
34
|
+
/** Actions run in the same turn (besides `set_cues`). */
|
|
35
|
+
actions: ReadonlyArray<{
|
|
36
|
+
name: string;
|
|
37
|
+
origin: string;
|
|
38
|
+
error?: string;
|
|
39
|
+
}>;
|
|
40
|
+
/** `source` of every `error` event in the same turn. */
|
|
41
|
+
errors: readonly string[];
|
|
42
|
+
/** Cut short by `h4b.interrupt()`. */
|
|
43
|
+
interrupted: boolean;
|
|
44
|
+
/** The signal that started the turn, if any. */
|
|
45
|
+
trigger?: Signal;
|
|
46
|
+
};
|
|
47
|
+
/** Declarative condition: every key given must match. */
|
|
48
|
+
export type CueCondition = {
|
|
49
|
+
/** Matches when some source of the message matches every field given. */
|
|
50
|
+
source?: {
|
|
51
|
+
urlPrefix?: string;
|
|
52
|
+
trail?: string;
|
|
53
|
+
title?: string;
|
|
54
|
+
taxonomy?: string;
|
|
55
|
+
};
|
|
56
|
+
/** Some source was classified under this taxonomy. */
|
|
57
|
+
taxonomy?: string;
|
|
58
|
+
/** An action with this name ran in the turn. */
|
|
59
|
+
action?: string;
|
|
60
|
+
/** `error`: an error happened in the turn; `action.failed`: an action failed or was refused; `interrupted`: the message was cut. */
|
|
61
|
+
event?: 'error' | 'action.failed' | 'interrupted';
|
|
62
|
+
/** Modality of the signal that started the turn. */
|
|
63
|
+
trigger?: Modality;
|
|
64
|
+
/** Tested against the message's text. */
|
|
65
|
+
text?: RegExp;
|
|
66
|
+
};
|
|
67
|
+
export type CueRule = {
|
|
68
|
+
when: CueCondition | ((context: CueRuleContext) => boolean);
|
|
69
|
+
/** Values to set, per channel. */
|
|
70
|
+
set: Record<string, string>;
|
|
71
|
+
/** Higher wins. Ties: the last rule declared. Default 0. */
|
|
72
|
+
priority?: number;
|
|
73
|
+
};
|
|
74
|
+
export type CuesOptions = {
|
|
75
|
+
channels: Record<string, CueChannel>;
|
|
76
|
+
rules?: CueRule[];
|
|
77
|
+
/** Taxonomies of a source, for rules with `taxonomy`. */
|
|
78
|
+
classify?: (source: SourcePart) => readonly string[];
|
|
79
|
+
/** Sends the current state to the backend as the context signal `cues.state`. Recommended with `max`. */
|
|
80
|
+
report?: boolean;
|
|
81
|
+
/** Registers the `set_cues` action for backends that use tool calling. Default true; a string renames it. */
|
|
82
|
+
action?: boolean | string;
|
|
83
|
+
/**
|
|
84
|
+
* When the page sees a reply's cues. `'speech'` (default): when the `voice`
|
|
85
|
+
* plugin speaks the reply, its cues wait for its first spoken chunk; replies
|
|
86
|
+
* that are not spoken show them on arrival. `'arrival'`: always on arrival.
|
|
87
|
+
*/
|
|
88
|
+
sync?: 'speech' | 'arrival';
|
|
89
|
+
};
|
|
90
|
+
/** Who decided a value. */
|
|
91
|
+
export type CueFrom = 'backend' | 'rule' | 'default' | 'sticky' | 'repeat';
|
|
92
|
+
export type CueState = {
|
|
93
|
+
value: string;
|
|
94
|
+
/** Value of the previous message. */
|
|
95
|
+
previous?: string;
|
|
96
|
+
/** Assistant messages in a row with `value`, this one included (0 before any message). */
|
|
97
|
+
streak: number;
|
|
98
|
+
/** Assistant messages with `value` in the conversation, this one included. */
|
|
99
|
+
count: number;
|
|
100
|
+
/** 1 plus the `levels` reached. */
|
|
101
|
+
level: number;
|
|
102
|
+
from: CueFrom;
|
|
103
|
+
/** The value asked for, when the repetition policy replaced it. */
|
|
104
|
+
requested?: string;
|
|
105
|
+
messageId?: string;
|
|
106
|
+
/** Not stored yet: set by the backend while the message is still arriving. */
|
|
107
|
+
pending?: boolean;
|
|
108
|
+
};
|
|
109
|
+
export type CuesState = Readonly<Record<string, CueState>>;
|
|
110
|
+
/** Stored in the assistant message as `{ type: 'data', name: 'cues', value }`. */
|
|
111
|
+
export type StoredCues = Record<string, {
|
|
112
|
+
value: string;
|
|
113
|
+
level: number;
|
|
114
|
+
from: CueFrom;
|
|
115
|
+
requested?: string;
|
|
116
|
+
}>;
|
|
117
|
+
export type CuesControl = {
|
|
118
|
+
getState(): CuesState;
|
|
119
|
+
subscribe(listener: () => void): () => void;
|
|
120
|
+
/** Channel definitions, as validated. */
|
|
121
|
+
readonly channels: Readonly<Record<string, CueChannel>>;
|
|
122
|
+
/** JSON Schema of the `set_cues` arguments (one `enum` per channel). */
|
|
123
|
+
schema(): Record<string, unknown>;
|
|
124
|
+
};
|
|
125
|
+
declare module '@handsforbots/core' {
|
|
126
|
+
interface Services {
|
|
127
|
+
cues: CuesControl;
|
|
128
|
+
}
|
|
129
|
+
interface Events {
|
|
130
|
+
/** A channel's state changed (ADR 0018). */
|
|
131
|
+
'cue.changed': CueState & {
|
|
132
|
+
channel: string;
|
|
133
|
+
};
|
|
134
|
+
/** A repetition level was reached or a value was replaced by its policy. */
|
|
135
|
+
'cue.repeat': {
|
|
136
|
+
channel: string;
|
|
137
|
+
value: string;
|
|
138
|
+
level: number;
|
|
139
|
+
streak: number;
|
|
140
|
+
count: number;
|
|
141
|
+
replaced?: string;
|
|
142
|
+
messageId: string;
|
|
143
|
+
};
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
export declare const CUES_PART = "cues";
|
|
147
|
+
export declare const CUES_CONTEXT_KEY = "cues.state";
|
|
148
|
+
/**
|
|
149
|
+
* Cues (ADR 0018): presentation categories with a closed vocabulary, set by
|
|
150
|
+
* the backend (`ui.effect` named `cues` or the `set_cues` action) or by rules
|
|
151
|
+
* tied to the content, counted per value and limited by repetition policies.
|
|
152
|
+
* Stored in each assistant message; the page decides what each value means.
|
|
153
|
+
*/
|
|
154
|
+
export declare const cues: (config: CuesOptions) => import("@handsforbots/core").Plugin<CuesOptions>;
|
|
155
|
+
//# 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,583 @@
|
|
|
1
|
+
import { definePlugin, textOf, } from '@handsforbots/core';
|
|
2
|
+
export const CUES_PART = 'cues';
|
|
3
|
+
export const CUES_CONTEXT_KEY = 'cues.state';
|
|
4
|
+
const CODE = /^[A-Za-z0-9_.:-]{1,64}$/;
|
|
5
|
+
const CHANNEL = /^[a-z][a-z0-9-]{0,31}$/;
|
|
6
|
+
/* -------------------------------------------------------------------------- */
|
|
7
|
+
/* Validation */
|
|
8
|
+
/* -------------------------------------------------------------------------- */
|
|
9
|
+
function checkChannels(channels) {
|
|
10
|
+
const names = Object.keys(channels ?? {});
|
|
11
|
+
if (!names.length)
|
|
12
|
+
throw new Error('[h4b] cues: declare at least one channel.');
|
|
13
|
+
for (const name of names) {
|
|
14
|
+
const channel = channels[name];
|
|
15
|
+
const where = `[h4b] cues: channel "${name}"`;
|
|
16
|
+
if (!CHANNEL.test(name))
|
|
17
|
+
throw new Error(`${where}: names are lowercase letters, digits and "-", starting with a letter.`);
|
|
18
|
+
if (!Array.isArray(channel.values) || !channel.values.length)
|
|
19
|
+
throw new Error(`${where} needs values.`);
|
|
20
|
+
for (const value of channel.values) {
|
|
21
|
+
if (typeof value !== 'string' || !CODE.test(value))
|
|
22
|
+
throw new Error(`${where}: "${value}" is not a code ([A-Za-z0-9_.:-]{1,64}).`);
|
|
23
|
+
}
|
|
24
|
+
if (!channel.values.includes(channel.default))
|
|
25
|
+
throw new Error(`${where}: default "${channel.default}" is not in values.`);
|
|
26
|
+
for (const [value, policy] of Object.entries(channel.repeat ?? {})) {
|
|
27
|
+
if (!channel.values.includes(value))
|
|
28
|
+
throw new Error(`${where}: repeat for unknown value "${value}".`);
|
|
29
|
+
const levels = policy.levels ?? [];
|
|
30
|
+
if (!levels.every((n, i) => Number.isInteger(n) && n >= 2 && (i === 0 || n > levels[i - 1]))) {
|
|
31
|
+
throw new Error(`${where}: levels of "${value}" must be ascending integers from 2.`);
|
|
32
|
+
}
|
|
33
|
+
if (policy.max !== undefined && !(Number.isInteger(policy.max) && policy.max >= 0)) {
|
|
34
|
+
throw new Error(`${where}: max of "${value}" must be an integer ≥ 0.`);
|
|
35
|
+
}
|
|
36
|
+
if (policy.then !== undefined && !channel.values.includes(policy.then)) {
|
|
37
|
+
throw new Error(`${where}: then "${policy.then}" of "${value}" is not in values.`);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
return channels;
|
|
42
|
+
}
|
|
43
|
+
function cuesOf(message) {
|
|
44
|
+
if (message.role !== 'assistant')
|
|
45
|
+
return undefined;
|
|
46
|
+
const part = message.parts.find((p) => p.type === 'data' && p.name === CUES_PART);
|
|
47
|
+
return part && typeof part.value === 'object' && part.value !== null ? part.value : undefined;
|
|
48
|
+
}
|
|
49
|
+
function emptyCounters(names) {
|
|
50
|
+
return new Map(names.map((name) => [name, { streak: 0, counts: new Map() }]));
|
|
51
|
+
}
|
|
52
|
+
function count(counters, stored) {
|
|
53
|
+
for (const [name, counter] of counters) {
|
|
54
|
+
const entry = stored[name];
|
|
55
|
+
if (!entry)
|
|
56
|
+
continue;
|
|
57
|
+
counter.streak = counter.last === entry.value ? counter.streak + 1 : 1;
|
|
58
|
+
counter.last = entry.value;
|
|
59
|
+
counter.counts.set(entry.value, (counter.counts.get(entry.value) ?? 0) + 1);
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
/** Decides one channel for one message, from what was asked and what came before. */
|
|
63
|
+
function decide(channel, counter, asked) {
|
|
64
|
+
let { value, from } = asked;
|
|
65
|
+
let requested;
|
|
66
|
+
const occurrences = (v, by) => by === 'count' ? (counter.counts.get(v) ?? 0) + 1 : counter.last === v ? counter.streak + 1 : 1;
|
|
67
|
+
const policy = channel.repeat?.[value];
|
|
68
|
+
if (policy?.max !== undefined && occurrences(value, policy.by) > policy.max) {
|
|
69
|
+
const replacement = policy.then ?? channel.default;
|
|
70
|
+
if (replacement !== value) {
|
|
71
|
+
requested = value;
|
|
72
|
+
value = replacement;
|
|
73
|
+
from = 'repeat';
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
const levels = channel.repeat?.[value]?.levels ?? [];
|
|
77
|
+
const n = occurrences(value, channel.repeat?.[value]?.by);
|
|
78
|
+
let level = 1 + levels.filter((t) => n >= t).length;
|
|
79
|
+
if (asked.level !== undefined && from === 'backend')
|
|
80
|
+
level = Math.min(Math.max(1, Math.round(asked.level)), levels.length + 1);
|
|
81
|
+
return {
|
|
82
|
+
stored: { value, level, from, ...(requested ? { requested } : {}) },
|
|
83
|
+
streak: counter.last === value ? counter.streak + 1 : 1,
|
|
84
|
+
count: (counter.counts.get(value) ?? 0) + 1,
|
|
85
|
+
crossed: levels.includes(n),
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
/* -------------------------------------------------------------------------- */
|
|
89
|
+
/* Rules */
|
|
90
|
+
/* -------------------------------------------------------------------------- */
|
|
91
|
+
function matches(condition, context, classify) {
|
|
92
|
+
if (condition.source) {
|
|
93
|
+
const { urlPrefix, trail, title, taxonomy } = condition.source;
|
|
94
|
+
const hit = context.sources.some((s) => (urlPrefix === undefined || (s.url ?? '').startsWith(urlPrefix)) &&
|
|
95
|
+
(trail === undefined || (s.trail ?? []).includes(trail)) &&
|
|
96
|
+
(title === undefined || s.title.includes(title)) &&
|
|
97
|
+
(taxonomy === undefined || classify(s).includes(taxonomy)));
|
|
98
|
+
if (!hit)
|
|
99
|
+
return false;
|
|
100
|
+
}
|
|
101
|
+
if (condition.taxonomy !== undefined && !context.taxonomies.has(condition.taxonomy))
|
|
102
|
+
return false;
|
|
103
|
+
if (condition.action !== undefined && !context.actions.some((a) => a.name === condition.action))
|
|
104
|
+
return false;
|
|
105
|
+
if (condition.event === 'error' && !context.errors.length)
|
|
106
|
+
return false;
|
|
107
|
+
if (condition.event === 'action.failed' && !context.actions.some((a) => a.error))
|
|
108
|
+
return false;
|
|
109
|
+
if (condition.event === 'interrupted' && !context.interrupted)
|
|
110
|
+
return false;
|
|
111
|
+
if (condition.trigger !== undefined && context.trigger?.modality !== condition.trigger)
|
|
112
|
+
return false;
|
|
113
|
+
if (condition.text) {
|
|
114
|
+
condition.text.lastIndex = 0;
|
|
115
|
+
if (!condition.text.test(context.text))
|
|
116
|
+
return false;
|
|
117
|
+
}
|
|
118
|
+
return true;
|
|
119
|
+
}
|
|
120
|
+
const definition = {
|
|
121
|
+
name: 'cues',
|
|
122
|
+
provides: ['cues'],
|
|
123
|
+
apply(ctx, options) {
|
|
124
|
+
const channels = checkChannels(options.channels);
|
|
125
|
+
const names = Object.keys(channels);
|
|
126
|
+
const rules = (options.rules ?? []).map((rule, index) => ({ ...rule, index }));
|
|
127
|
+
const actionName = typeof options.action === 'string' ? options.action : 'set_cues';
|
|
128
|
+
const app = ctx.app;
|
|
129
|
+
const report = (error) => ctx.emit('error', { error, source: 'cues' });
|
|
130
|
+
const classify = (source) => {
|
|
131
|
+
if (!options.classify)
|
|
132
|
+
return [];
|
|
133
|
+
try {
|
|
134
|
+
const result = options.classify(source);
|
|
135
|
+
return Array.isArray(result) ? result : [];
|
|
136
|
+
}
|
|
137
|
+
catch (error) {
|
|
138
|
+
report(error);
|
|
139
|
+
return [];
|
|
140
|
+
}
|
|
141
|
+
};
|
|
142
|
+
const turns = new Map();
|
|
143
|
+
let currentTurn;
|
|
144
|
+
const turn = (turnId) => {
|
|
145
|
+
let info = turns.get(turnId);
|
|
146
|
+
if (!info)
|
|
147
|
+
turns.set(turnId, (info = { actions: [], errors: [], asked: {} }));
|
|
148
|
+
return info;
|
|
149
|
+
};
|
|
150
|
+
/** Validates `{ channel: value | { value, level } }`; unknown channels and values are reported. */
|
|
151
|
+
const read = (input) => {
|
|
152
|
+
const out = {};
|
|
153
|
+
if (typeof input !== 'object' || input === null) {
|
|
154
|
+
report(new Error('Cues must be an object of channel → value.'));
|
|
155
|
+
return out;
|
|
156
|
+
}
|
|
157
|
+
for (const [name, raw] of Object.entries(input)) {
|
|
158
|
+
if (name === 'messageId')
|
|
159
|
+
continue;
|
|
160
|
+
const channel = channels[name];
|
|
161
|
+
if (!channel) {
|
|
162
|
+
report(new Error(`Unknown cue channel "${name}" was dropped.`));
|
|
163
|
+
continue;
|
|
164
|
+
}
|
|
165
|
+
const value = typeof raw === 'string' ? raw : typeof raw === 'object' && raw ? raw.value : undefined;
|
|
166
|
+
const level = typeof raw === 'object' && raw && typeof raw.level === 'number' ? raw.level : undefined;
|
|
167
|
+
if (typeof value !== 'string' || !channel.values.includes(value)) {
|
|
168
|
+
report(new Error(`Cue "${String(value)}" is not a value of "${name}"; using "${channel.default}".`));
|
|
169
|
+
out[name] = { value: channel.default };
|
|
170
|
+
continue;
|
|
171
|
+
}
|
|
172
|
+
out[name] = level === undefined || !Number.isFinite(level) ? { value } : { value, level };
|
|
173
|
+
}
|
|
174
|
+
return out;
|
|
175
|
+
};
|
|
176
|
+
/* ---------------------------------------------------------------- */
|
|
177
|
+
/* State */
|
|
178
|
+
/* ---------------------------------------------------------------- */
|
|
179
|
+
const initial = () => Object.fromEntries(names.map((name) => [name, { value: channels[name].default, streak: 0, count: 0, level: 1, from: 'default' }]));
|
|
180
|
+
let state = initial();
|
|
181
|
+
let known = [];
|
|
182
|
+
/** Backend values shown before their message is stored. */
|
|
183
|
+
let overlay = {};
|
|
184
|
+
const listeners = new Set();
|
|
185
|
+
/** Counters from the stored cues of the messages before `index` (all when absent). */
|
|
186
|
+
const countersBefore = (messages, index = messages.length) => {
|
|
187
|
+
const counters = emptyCounters(names);
|
|
188
|
+
for (let i = 0; i < index; i++) {
|
|
189
|
+
const stored = cuesOf(messages[i]);
|
|
190
|
+
if (stored)
|
|
191
|
+
count(counters, stored);
|
|
192
|
+
}
|
|
193
|
+
return counters;
|
|
194
|
+
};
|
|
195
|
+
const replay = (messages, skip) => {
|
|
196
|
+
const next = initial();
|
|
197
|
+
const counters = emptyCounters(names);
|
|
198
|
+
for (const message of messages) {
|
|
199
|
+
const stored = cuesOf(message);
|
|
200
|
+
if (!stored || skip?.has(message.id))
|
|
201
|
+
continue;
|
|
202
|
+
count(counters, stored);
|
|
203
|
+
for (const name of names) {
|
|
204
|
+
const entry = stored[name];
|
|
205
|
+
const counter = counters.get(name);
|
|
206
|
+
if (!entry)
|
|
207
|
+
continue;
|
|
208
|
+
next[name] = {
|
|
209
|
+
value: entry.value,
|
|
210
|
+
previous: next[name].messageId ? next[name].value : undefined,
|
|
211
|
+
streak: counter.streak,
|
|
212
|
+
count: counter.counts.get(entry.value) ?? 0,
|
|
213
|
+
level: entry.level,
|
|
214
|
+
from: entry.from,
|
|
215
|
+
...(entry.requested ? { requested: entry.requested } : {}),
|
|
216
|
+
messageId: message.id,
|
|
217
|
+
};
|
|
218
|
+
if (next[name].previous === undefined)
|
|
219
|
+
delete next[name].previous;
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
return next;
|
|
223
|
+
};
|
|
224
|
+
const same = (a, b) => !!a &&
|
|
225
|
+
a.value === b.value &&
|
|
226
|
+
a.level === b.level &&
|
|
227
|
+
a.streak === b.streak &&
|
|
228
|
+
a.count === b.count &&
|
|
229
|
+
a.from === b.from &&
|
|
230
|
+
a.messageId === b.messageId &&
|
|
231
|
+
a.requested === b.requested &&
|
|
232
|
+
a.pending === b.pending;
|
|
233
|
+
/* Speech sync: replies the voice will speak wait for their first chunk. */
|
|
234
|
+
const speechSync = options.sync !== 'arrival';
|
|
235
|
+
const held = new Set();
|
|
236
|
+
const heldTurns = new Set();
|
|
237
|
+
let overlayTurn;
|
|
238
|
+
const voice = () => (speechSync ? app.get('voice') : undefined);
|
|
239
|
+
const turnOf = (messageId) => app.conversation.find(messageId)?.turnId;
|
|
240
|
+
const releaseTurn = (turnId) => {
|
|
241
|
+
if (!turnId)
|
|
242
|
+
return;
|
|
243
|
+
for (const id of held)
|
|
244
|
+
if (turnOf(id) === turnId)
|
|
245
|
+
return;
|
|
246
|
+
heldTurns.delete(turnId);
|
|
247
|
+
};
|
|
248
|
+
const release = (messageId) => {
|
|
249
|
+
if (!held.delete(messageId))
|
|
250
|
+
return;
|
|
251
|
+
releaseTurn(turnOf(messageId));
|
|
252
|
+
publish();
|
|
253
|
+
};
|
|
254
|
+
const releaseAll = () => {
|
|
255
|
+
if (!held.size && !heldTurns.size)
|
|
256
|
+
return;
|
|
257
|
+
held.clear();
|
|
258
|
+
heldTurns.clear();
|
|
259
|
+
publish();
|
|
260
|
+
};
|
|
261
|
+
/** What was decided, spoken or not (for the backend). */
|
|
262
|
+
const actual = () => ({ ...replay(app.messages), ...overlay });
|
|
263
|
+
const publish = () => {
|
|
264
|
+
const base = replay(app.messages, held);
|
|
265
|
+
const next = { ...base, ...(overlayTurn && heldTurns.has(overlayTurn) ? {} : overlay) };
|
|
266
|
+
const changed = names.filter((name) => !same(state[name], next[name]));
|
|
267
|
+
if (!changed.length)
|
|
268
|
+
return;
|
|
269
|
+
state = Object.freeze(next);
|
|
270
|
+
for (const name of changed)
|
|
271
|
+
ctx.emit('cue.changed', { channel: name, ...state[name] });
|
|
272
|
+
for (const listener of listeners) {
|
|
273
|
+
try {
|
|
274
|
+
listener();
|
|
275
|
+
}
|
|
276
|
+
catch (error) {
|
|
277
|
+
report(error);
|
|
278
|
+
}
|
|
279
|
+
}
|
|
280
|
+
};
|
|
281
|
+
/* ---------------------------------------------------------------- */
|
|
282
|
+
/* Deciding a message */
|
|
283
|
+
/* ---------------------------------------------------------------- */
|
|
284
|
+
const eligible = (message, info) => textOf(message).trim().length > 0 || (info?.messageId === message.id && Object.keys(info.asked).length > 0);
|
|
285
|
+
const contextFor = (message, info) => {
|
|
286
|
+
const sources = message.parts.filter((p) => p.type === 'source');
|
|
287
|
+
return {
|
|
288
|
+
message,
|
|
289
|
+
text: textOf(message),
|
|
290
|
+
sources,
|
|
291
|
+
taxonomies: new Set(sources.flatMap((s) => classify(s))),
|
|
292
|
+
actions: info?.actions ?? [],
|
|
293
|
+
errors: info?.errors ?? [],
|
|
294
|
+
interrupted: !!message.interrupted,
|
|
295
|
+
trigger: info?.trigger,
|
|
296
|
+
};
|
|
297
|
+
};
|
|
298
|
+
const fromRules = (context) => {
|
|
299
|
+
const chosen = {};
|
|
300
|
+
for (const rule of rules) {
|
|
301
|
+
let hit = false;
|
|
302
|
+
try {
|
|
303
|
+
hit = typeof rule.when === 'function' ? !!rule.when(context) : matches(rule.when, context, classify);
|
|
304
|
+
}
|
|
305
|
+
catch (error) {
|
|
306
|
+
report(error);
|
|
307
|
+
}
|
|
308
|
+
if (!hit)
|
|
309
|
+
continue;
|
|
310
|
+
const priority = rule.priority ?? 0;
|
|
311
|
+
for (const [name, value] of Object.entries(rule.set)) {
|
|
312
|
+
const channel = channels[name];
|
|
313
|
+
if (!channel || !channel.values.includes(value)) {
|
|
314
|
+
report(new Error(`Rule sets "${name}" to "${value}", which is not declared; ignored.`));
|
|
315
|
+
continue;
|
|
316
|
+
}
|
|
317
|
+
const current = chosen[name];
|
|
318
|
+
if (!current || priority >= current.priority)
|
|
319
|
+
chosen[name] = { value, priority, index: rule.index };
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
return Object.fromEntries(Object.entries(chosen).map(([name, c]) => [name, c.value]));
|
|
323
|
+
};
|
|
324
|
+
/** Decides and stores the cues of an assistant message. */
|
|
325
|
+
const settle = (messageId) => {
|
|
326
|
+
const messages = app.messages;
|
|
327
|
+
const index = messages.findIndex((m) => m.id === messageId);
|
|
328
|
+
const message = messages[index];
|
|
329
|
+
if (!message || message.role !== 'assistant')
|
|
330
|
+
return;
|
|
331
|
+
const info = message.turnId ? turns.get(message.turnId) : undefined;
|
|
332
|
+
const named = info?.messageId === undefined || info.messageId === message.id;
|
|
333
|
+
if (!eligible(message, info))
|
|
334
|
+
return;
|
|
335
|
+
const asked = named ? (info?.asked ?? {}) : {};
|
|
336
|
+
const fromBackend = Object.keys(asked).length > 0;
|
|
337
|
+
const previous = cuesOf(message);
|
|
338
|
+
// Already settled and nothing new from the backend: keep it (rules never rerun on old messages).
|
|
339
|
+
if (previous && !fromBackend)
|
|
340
|
+
return;
|
|
341
|
+
let ruled = {};
|
|
342
|
+
try {
|
|
343
|
+
ruled = previous ? {} : fromRules(contextFor(message, info));
|
|
344
|
+
}
|
|
345
|
+
catch (error) {
|
|
346
|
+
report(error);
|
|
347
|
+
}
|
|
348
|
+
const counters = countersBefore(messages, index);
|
|
349
|
+
const stored = {};
|
|
350
|
+
for (const name of names) {
|
|
351
|
+
const channel = channels[name];
|
|
352
|
+
const counter = counters.get(name);
|
|
353
|
+
const prior = previous?.[name];
|
|
354
|
+
if (prior && !asked[name]) {
|
|
355
|
+
stored[name] = prior;
|
|
356
|
+
continue;
|
|
357
|
+
}
|
|
358
|
+
const choice = asked[name]
|
|
359
|
+
? { value: asked[name].value, from: 'backend', level: asked[name].level }
|
|
360
|
+
: ruled[name]
|
|
361
|
+
? { value: ruled[name], from: 'rule' }
|
|
362
|
+
: channel.persist === 'sticky' && counter.last !== undefined
|
|
363
|
+
? { value: counter.last, from: 'sticky' }
|
|
364
|
+
: { value: channel.default, from: 'default' };
|
|
365
|
+
const result = decide(channel, counter, choice);
|
|
366
|
+
stored[name] = result.stored;
|
|
367
|
+
if (result.stored.requested || result.crossed) {
|
|
368
|
+
ctx.emit('cue.repeat', {
|
|
369
|
+
channel: name,
|
|
370
|
+
value: result.stored.value,
|
|
371
|
+
level: result.stored.level,
|
|
372
|
+
streak: result.streak,
|
|
373
|
+
count: result.count,
|
|
374
|
+
...(result.stored.requested ? { replaced: result.stored.requested } : {}),
|
|
375
|
+
messageId: message.id,
|
|
376
|
+
});
|
|
377
|
+
}
|
|
378
|
+
}
|
|
379
|
+
if (named && info) {
|
|
380
|
+
info.asked = {};
|
|
381
|
+
info.messageId = undefined;
|
|
382
|
+
}
|
|
383
|
+
overlay = {};
|
|
384
|
+
app.conversation.update(message.id, (m) => {
|
|
385
|
+
const part = { type: 'data', name: CUES_PART, value: stored };
|
|
386
|
+
const at = m.parts.findIndex((p) => p.type === 'data' && p.name === CUES_PART);
|
|
387
|
+
return { ...m, parts: at < 0 ? [...m.parts, part] : m.parts.with(at, part) };
|
|
388
|
+
});
|
|
389
|
+
};
|
|
390
|
+
/** Shows backend values right away, before the message is stored. */
|
|
391
|
+
const preview = (turnId) => {
|
|
392
|
+
const info = turns.get(turnId);
|
|
393
|
+
if (!info)
|
|
394
|
+
return;
|
|
395
|
+
const messages = app.messages;
|
|
396
|
+
const target = info.messageId
|
|
397
|
+
? messages.findIndex((m) => m.id === info.messageId)
|
|
398
|
+
: messages.findLastIndex((m) => m.role === 'assistant' && m.turnId === turnId && !cuesOf(m));
|
|
399
|
+
const counters = countersBefore(messages, target < 0 ? messages.length : target);
|
|
400
|
+
const next = {};
|
|
401
|
+
for (const [name, asked] of Object.entries(info.asked)) {
|
|
402
|
+
const result = decide(channels[name], counters.get(name), { value: asked.value, from: 'backend', level: asked.level });
|
|
403
|
+
next[name] = {
|
|
404
|
+
...result.stored,
|
|
405
|
+
previous: counters.get(name).last,
|
|
406
|
+
streak: result.streak,
|
|
407
|
+
count: result.count,
|
|
408
|
+
messageId: target < 0 ? undefined : messages[target].id,
|
|
409
|
+
pending: true,
|
|
410
|
+
};
|
|
411
|
+
if (next[name].previous === undefined)
|
|
412
|
+
delete next[name].previous;
|
|
413
|
+
if (next[name].messageId === undefined)
|
|
414
|
+
delete next[name].messageId;
|
|
415
|
+
}
|
|
416
|
+
overlay = next;
|
|
417
|
+
overlayTurn = turnId;
|
|
418
|
+
if (voice()?.willSpeakReplies?.())
|
|
419
|
+
heldTurns.add(turnId);
|
|
420
|
+
publish();
|
|
421
|
+
};
|
|
422
|
+
const ask = (turnId, input) => {
|
|
423
|
+
const values = read(input);
|
|
424
|
+
if (!turnId || !Object.keys(values).length)
|
|
425
|
+
return values;
|
|
426
|
+
const info = turn(turnId);
|
|
427
|
+
const messageId = typeof input?.messageId === 'string' ? input.messageId : undefined;
|
|
428
|
+
if (messageId)
|
|
429
|
+
info.messageId = messageId;
|
|
430
|
+
Object.assign(info.asked, values);
|
|
431
|
+
// A message the backend named that was already stored: decide it again now.
|
|
432
|
+
const target = messageId && app.messages.find((m) => m.id === messageId);
|
|
433
|
+
if (target && cuesOf(target))
|
|
434
|
+
settle(messageId);
|
|
435
|
+
else
|
|
436
|
+
preview(turnId);
|
|
437
|
+
return values;
|
|
438
|
+
};
|
|
439
|
+
const finishTurn = (turnId) => {
|
|
440
|
+
for (const message of app.messages) {
|
|
441
|
+
if (message.role === 'assistant' && message.turnId === turnId && !cuesOf(message))
|
|
442
|
+
settle(message.id);
|
|
443
|
+
}
|
|
444
|
+
turns.delete(turnId);
|
|
445
|
+
if (currentTurn === turnId)
|
|
446
|
+
currentTurn = undefined;
|
|
447
|
+
overlay = {};
|
|
448
|
+
releaseTurn(turnId);
|
|
449
|
+
publish();
|
|
450
|
+
};
|
|
451
|
+
/* ---------------------------------------------------------------- */
|
|
452
|
+
/* Wiring */
|
|
453
|
+
/* ---------------------------------------------------------------- */
|
|
454
|
+
ctx.on('turn.status', (status) => {
|
|
455
|
+
if (status.phase === 'received' || status.phase === 'acting') {
|
|
456
|
+
currentTurn = status.turnId;
|
|
457
|
+
const info = turn(status.turnId);
|
|
458
|
+
if (status.signal)
|
|
459
|
+
info.trigger = status.signal;
|
|
460
|
+
}
|
|
461
|
+
else {
|
|
462
|
+
finishTurn(status.turnId);
|
|
463
|
+
}
|
|
464
|
+
});
|
|
465
|
+
ctx.on('action.invoked', (invocation) => {
|
|
466
|
+
if (!currentTurn || invocation.name === actionName)
|
|
467
|
+
return;
|
|
468
|
+
turn(currentTurn).actions.push({ name: invocation.name, origin: invocation.origin, ...(invocation.error ? { error: invocation.error } : {}) });
|
|
469
|
+
});
|
|
470
|
+
ctx.on('error', ({ source }) => {
|
|
471
|
+
if (currentTurn && source !== 'cues')
|
|
472
|
+
turn(currentTurn).errors.push(source);
|
|
473
|
+
});
|
|
474
|
+
ctx.on('stimulus', ({ turnId, stimulus }) => {
|
|
475
|
+
if (stimulus.type === 'ui.effect' && stimulus.name === CUES_PART)
|
|
476
|
+
ask(turnId, stimulus.value);
|
|
477
|
+
else if (stimulus.type === 'message.end')
|
|
478
|
+
settle(stimulus.messageId);
|
|
479
|
+
});
|
|
480
|
+
if (speechSync) {
|
|
481
|
+
const onPlugin = ctx.on.bind(ctx);
|
|
482
|
+
onPlugin('voice.track', ({ messageId, speak }) => {
|
|
483
|
+
const turnId = turnOf(messageId);
|
|
484
|
+
if (speak) {
|
|
485
|
+
held.add(messageId);
|
|
486
|
+
if (turnId)
|
|
487
|
+
heldTurns.add(turnId);
|
|
488
|
+
publish();
|
|
489
|
+
}
|
|
490
|
+
else if (turnId && heldTurns.has(turnId)) {
|
|
491
|
+
releaseTurn(turnId);
|
|
492
|
+
publish();
|
|
493
|
+
}
|
|
494
|
+
});
|
|
495
|
+
// Started, ended, failed or skipped: the reply reached (or will never reach) the speakers.
|
|
496
|
+
onPlugin('voice.speech', ({ messageId }) => {
|
|
497
|
+
if (messageId)
|
|
498
|
+
release(messageId);
|
|
499
|
+
});
|
|
500
|
+
ctx.on('turn.interrupted', releaseAll);
|
|
501
|
+
ctx.on('service.removed', ({ key }) => {
|
|
502
|
+
if (key === 'voice')
|
|
503
|
+
releaseAll();
|
|
504
|
+
});
|
|
505
|
+
}
|
|
506
|
+
ctx.on('messages.changed', (messages) => {
|
|
507
|
+
if (held.size) {
|
|
508
|
+
const ids = new Set(messages.map((m) => m.id));
|
|
509
|
+
for (const id of held)
|
|
510
|
+
if (!ids.has(id))
|
|
511
|
+
held.delete(id);
|
|
512
|
+
if (!held.size)
|
|
513
|
+
heldTurns.clear();
|
|
514
|
+
}
|
|
515
|
+
const stored = messages.map(cuesOf).filter((c) => !!c);
|
|
516
|
+
if (stored.length === known.length && stored.every((c, i) => c === known[i]))
|
|
517
|
+
return;
|
|
518
|
+
known = stored;
|
|
519
|
+
publish();
|
|
520
|
+
});
|
|
521
|
+
if (options.action !== false) {
|
|
522
|
+
const properties = Object.fromEntries(names.map((name) => [
|
|
523
|
+
name,
|
|
524
|
+
{ type: 'string', enum: [...channels[name].values], ...(channels[name].description ? { description: channels[name].description } : {}) },
|
|
525
|
+
]));
|
|
526
|
+
ctx.registerAction({
|
|
527
|
+
name: actionName,
|
|
528
|
+
description: 'Sets presentation cues for the reply (for example the tone). Use only the listed values.',
|
|
529
|
+
parameters: { type: 'object', properties, additionalProperties: false },
|
|
530
|
+
confirm: 'never',
|
|
531
|
+
exposeTo: ['assistant', 'agent'],
|
|
532
|
+
handler: (args) => {
|
|
533
|
+
const values = ask(currentTurn, args);
|
|
534
|
+
const now = actual();
|
|
535
|
+
return Object.fromEntries(Object.keys(values).map((name) => [name, { ...now[name] }]));
|
|
536
|
+
},
|
|
537
|
+
});
|
|
538
|
+
}
|
|
539
|
+
if (options.report) {
|
|
540
|
+
ctx.intercept('request.before', (request) => {
|
|
541
|
+
const now = actual();
|
|
542
|
+
const value = Object.fromEntries(names.map((name) => {
|
|
543
|
+
const s = now[name];
|
|
544
|
+
return [name, { value: s.value, streak: s.streak, count: s.count, level: s.level, ...(s.requested ? { requested: s.requested } : {}) }];
|
|
545
|
+
}));
|
|
546
|
+
const signal = {
|
|
547
|
+
id: 'cues-state',
|
|
548
|
+
kind: 'context',
|
|
549
|
+
key: CUES_CONTEXT_KEY,
|
|
550
|
+
modality: 'text',
|
|
551
|
+
source: 'cues',
|
|
552
|
+
parts: [{ type: 'data', name: CUES_CONTEXT_KEY, value }],
|
|
553
|
+
timestamp: Date.now(),
|
|
554
|
+
};
|
|
555
|
+
return { ...request, context: [...request.context.filter((s) => s.key !== CUES_CONTEXT_KEY), signal] };
|
|
556
|
+
});
|
|
557
|
+
}
|
|
558
|
+
const control = {
|
|
559
|
+
getState: () => state,
|
|
560
|
+
subscribe(listener) {
|
|
561
|
+
listeners.add(listener);
|
|
562
|
+
return () => void listeners.delete(listener);
|
|
563
|
+
},
|
|
564
|
+
channels,
|
|
565
|
+
schema: () => ({
|
|
566
|
+
type: 'object',
|
|
567
|
+
properties: Object.fromEntries(names.map((name) => [name, { type: 'string', enum: [...channels[name].values] }])),
|
|
568
|
+
additionalProperties: false,
|
|
569
|
+
}),
|
|
570
|
+
};
|
|
571
|
+
ctx.provide('cues', control);
|
|
572
|
+
known = app.messages.map(cuesOf).filter((c) => !!c);
|
|
573
|
+
publish();
|
|
574
|
+
},
|
|
575
|
+
};
|
|
576
|
+
/**
|
|
577
|
+
* Cues (ADR 0018): presentation categories with a closed vocabulary, set by
|
|
578
|
+
* the backend (`ui.effect` named `cues` or the `set_cues` action) or by rules
|
|
579
|
+
* tied to the content, counted per value and limited by repetition policies.
|
|
580
|
+
* Stored in each assistant message; the page decides what each value means.
|
|
581
|
+
*/
|
|
582
|
+
export const cues = definePlugin(definition);
|
|
583
|
+
//# 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/dist/server.d.ts
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* For the backend (Node, Deno, edge): reads the `cues.state` context signal
|
|
3
|
+
* the page sends with `cues({ report: true })` (ADR 0018), keeping only the
|
|
4
|
+
* channels and values you allow and bounded integers. No dependency on the
|
|
5
|
+
* browser or on `@handsforbots/core`.
|
|
6
|
+
*
|
|
7
|
+
* It comes from the browser, so anyone can forge it: use it as a hint for
|
|
8
|
+
* wording the reply. A rule that must hold (such as "warn only once") needs a
|
|
9
|
+
* count the backend keeps itself.
|
|
10
|
+
*/
|
|
11
|
+
export declare const CUES_STATE = "cues.state";
|
|
12
|
+
/** Allowed values per channel: a list, or a channel declaration from `cues({ channels })`. */
|
|
13
|
+
export type AllowedCues = Readonly<Record<string, readonly string[] | DeclaredChannel>>;
|
|
14
|
+
/** The parts of a `cues({ channels })` declaration the reader uses. */
|
|
15
|
+
export type DeclaredChannel = {
|
|
16
|
+
readonly values: readonly string[];
|
|
17
|
+
readonly repeat?: Readonly<Record<string, {
|
|
18
|
+
readonly levels?: readonly number[];
|
|
19
|
+
readonly [key: string]: unknown;
|
|
20
|
+
}>>;
|
|
21
|
+
};
|
|
22
|
+
export type ReadCuesOptions = {
|
|
23
|
+
/** Highest `streak` and `count` kept. Default 10000. */
|
|
24
|
+
maxCount?: number;
|
|
25
|
+
/** Highest `level` for channels given as a plain list. Default 16. A declaration allows 1 plus its `levels` for that value. */
|
|
26
|
+
maxLevel?: number;
|
|
27
|
+
};
|
|
28
|
+
export type ReportedCue = {
|
|
29
|
+
value: string;
|
|
30
|
+
streak: number;
|
|
31
|
+
count: number;
|
|
32
|
+
level: number;
|
|
33
|
+
requested?: string;
|
|
34
|
+
};
|
|
35
|
+
/**
|
|
36
|
+
* Where the state can come from:
|
|
37
|
+
* - the AG-UI `context` array (`{ description, value: 'cues.state: {…}' }`, from `@handsforbots/transport-agui`);
|
|
38
|
+
* - the context object of `@handsforbots/transport-http` (`{ 'cues.state': [{…}] }`);
|
|
39
|
+
* - an array of H4B signals (a `data` part named `cues.state`);
|
|
40
|
+
* - the value itself, as an object or a string (`'cues.state: {…}'` or JSON).
|
|
41
|
+
*/
|
|
42
|
+
export type CuesSource = unknown;
|
|
43
|
+
/**
|
|
44
|
+
* const cues = readCuesState(input.context, { tone: ['neutro', 'curioso', 'ofendido'] })
|
|
45
|
+
* if (cues.tone?.value === 'ofendido') …
|
|
46
|
+
*
|
|
47
|
+
* Returns only allowed channels whose `value` (and `requested`, when present)
|
|
48
|
+
* are allowed, with `streak`, `count` and `level` as integers in range.
|
|
49
|
+
* Anything malformed is left out; it never throws.
|
|
50
|
+
*/
|
|
51
|
+
export declare function readCuesState(source: CuesSource, allow: AllowedCues, options?: ReadCuesOptions): Record<string, ReportedCue>;
|
|
52
|
+
//# sourceMappingURL=server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,UAAU,eAAe,CAAA;AAEtC,8FAA8F;AAC9F,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAAC,CAAC,CAAA;AAEvF,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC,CAAA;CACrH,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+HAA+H;IAC/H,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7G;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAA;AAEhC;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAuBhI"}
|
package/dist/server.js
ADDED
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* For the backend (Node, Deno, edge): reads the `cues.state` context signal
|
|
3
|
+
* the page sends with `cues({ report: true })` (ADR 0018), keeping only the
|
|
4
|
+
* channels and values you allow and bounded integers. No dependency on the
|
|
5
|
+
* browser or on `@handsforbots/core`.
|
|
6
|
+
*
|
|
7
|
+
* It comes from the browser, so anyone can forge it: use it as a hint for
|
|
8
|
+
* wording the reply. A rule that must hold (such as "warn only once") needs a
|
|
9
|
+
* count the backend keeps itself.
|
|
10
|
+
*/
|
|
11
|
+
export const CUES_STATE = 'cues.state';
|
|
12
|
+
/**
|
|
13
|
+
* const cues = readCuesState(input.context, { tone: ['neutro', 'curioso', 'ofendido'] })
|
|
14
|
+
* if (cues.tone?.value === 'ofendido') …
|
|
15
|
+
*
|
|
16
|
+
* Returns only allowed channels whose `value` (and `requested`, when present)
|
|
17
|
+
* are allowed, with `streak`, `count` and `level` as integers in range.
|
|
18
|
+
* Anything malformed is left out; it never throws.
|
|
19
|
+
*/
|
|
20
|
+
export function readCuesState(source, allow, options = {}) {
|
|
21
|
+
const raw = locate(source);
|
|
22
|
+
const result = {};
|
|
23
|
+
if (!isRecord(raw))
|
|
24
|
+
return result;
|
|
25
|
+
const maxCount = options.maxCount ?? 10000;
|
|
26
|
+
for (const [channel, declaration] of Object.entries(allow)) {
|
|
27
|
+
if (!Object.hasOwn(raw, channel))
|
|
28
|
+
continue;
|
|
29
|
+
const entry = raw[channel];
|
|
30
|
+
if (!isRecord(entry))
|
|
31
|
+
continue;
|
|
32
|
+
const declared = Array.isArray(declaration) ? undefined : declaration;
|
|
33
|
+
const values = declared ? declared.values : declaration;
|
|
34
|
+
const value = entry.value;
|
|
35
|
+
if (typeof value !== 'string' || !values.includes(value))
|
|
36
|
+
continue;
|
|
37
|
+
const streak = integer(entry.streak, 0, maxCount);
|
|
38
|
+
const count = integer(entry.count, 0, maxCount);
|
|
39
|
+
const maxLevel = declared ? (declared.repeat?.[value]?.levels?.length ?? 0) + 1 : (options.maxLevel ?? 16);
|
|
40
|
+
const level = integer(entry.level, 1, maxLevel);
|
|
41
|
+
if (streak === undefined || count === undefined || level === undefined)
|
|
42
|
+
continue;
|
|
43
|
+
const cue = { value, streak, count, level };
|
|
44
|
+
if (typeof entry.requested === 'string' && values.includes(entry.requested))
|
|
45
|
+
cue.requested = entry.requested;
|
|
46
|
+
result[channel] = cue;
|
|
47
|
+
}
|
|
48
|
+
return result;
|
|
49
|
+
}
|
|
50
|
+
function isRecord(value) {
|
|
51
|
+
return typeof value === 'object' && value !== null && !Array.isArray(value);
|
|
52
|
+
}
|
|
53
|
+
function integer(value, min, max) {
|
|
54
|
+
return typeof value === 'number' && Number.isInteger(value) && value >= min && value <= max ? value : undefined;
|
|
55
|
+
}
|
|
56
|
+
function parse(text) {
|
|
57
|
+
const body = text.trim().startsWith(`${CUES_STATE}:`) ? text.trim().slice(CUES_STATE.length + 1) : text;
|
|
58
|
+
try {
|
|
59
|
+
return JSON.parse(body);
|
|
60
|
+
}
|
|
61
|
+
catch {
|
|
62
|
+
return undefined;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
/** Finds the reported state in any of the shapes `CuesSource` lists. */
|
|
66
|
+
function locate(source) {
|
|
67
|
+
if (typeof source === 'string')
|
|
68
|
+
return parse(source);
|
|
69
|
+
if (Array.isArray(source)) {
|
|
70
|
+
for (const item of source) {
|
|
71
|
+
if (!isRecord(item))
|
|
72
|
+
continue;
|
|
73
|
+
// An H4B signal.
|
|
74
|
+
if (Array.isArray(item.parts)) {
|
|
75
|
+
const part = item.parts.find((p) => isRecord(p) && p.type === 'data' && p.name === CUES_STATE);
|
|
76
|
+
if (isRecord(part))
|
|
77
|
+
return part.value;
|
|
78
|
+
continue;
|
|
79
|
+
}
|
|
80
|
+
// An AG-UI context entry: the value starts with `cues.state: `.
|
|
81
|
+
if (typeof item.value === 'string' && item.value.trim().startsWith(`${CUES_STATE}:`))
|
|
82
|
+
return parse(item.value);
|
|
83
|
+
}
|
|
84
|
+
return undefined;
|
|
85
|
+
}
|
|
86
|
+
if (isRecord(source)) {
|
|
87
|
+
// The HTTP transport's context object: `{ 'cues.state': [state] }`.
|
|
88
|
+
if (Object.hasOwn(source, CUES_STATE)) {
|
|
89
|
+
const value = source[CUES_STATE];
|
|
90
|
+
return Array.isArray(value) ? value[0] : value;
|
|
91
|
+
}
|
|
92
|
+
return source;
|
|
93
|
+
}
|
|
94
|
+
return undefined;
|
|
95
|
+
}
|
|
96
|
+
//# sourceMappingURL=server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,52 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@handsforbots/cues",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
3
|
+
"version": "2.0.0-alpha.1",
|
|
4
|
+
"description": "Plugin. Cues for Hands for Bots: closed-vocabulary presentation categories (tone, scene, urgency…) set by the backend, an action or content rules, with repetition counts and policies.",
|
|
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#cues",
|
|
12
|
+
"repository": {
|
|
13
|
+
"type": "git",
|
|
14
|
+
"url": "git+https://github.com/handsforbots/handsforbots.git",
|
|
15
|
+
"directory": "packages/cues"
|
|
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
|
+
"./server": {
|
|
28
|
+
"types": "./dist/server.d.ts",
|
|
29
|
+
"import": "./dist/server.js"
|
|
30
|
+
}
|
|
31
|
+
},
|
|
32
|
+
"publishConfig": {
|
|
33
|
+
"access": "public"
|
|
34
|
+
},
|
|
35
|
+
"files": [
|
|
36
|
+
"dist"
|
|
37
|
+
],
|
|
38
|
+
"peerDependencies": {
|
|
39
|
+
"@handsforbots/core": "^2.0.0-alpha.1"
|
|
40
|
+
},
|
|
41
|
+
"devDependencies": {
|
|
42
|
+
"@handsforbots/voice": "^2.0.0-alpha.1",
|
|
43
|
+
"@handsforbots/core": "^2.0.0-alpha.1",
|
|
44
|
+
"@handsforbots/testkit": "^2.0.0-alpha.1",
|
|
45
|
+
"@handsforbots/transport-agui": "^2.0.0-alpha.1",
|
|
46
|
+
"@handsforbots/transport-http": "^2.0.0-alpha.1"
|
|
47
|
+
},
|
|
48
|
+
"scripts": {
|
|
49
|
+
"build": "tsc -p tsconfig.build.json",
|
|
50
|
+
"typecheck": "tsc -p tsconfig.json --noEmit"
|
|
51
|
+
}
|
|
6
52
|
}
|