@segmentstream/agent 0.23.16 → 0.24.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.
Files changed (68) hide show
  1. package/README.md +11 -10
  2. package/dist/_chunks/{build-metadata-D471R-eU.mjs → build-metadata-C5051bJL.mjs} +1 -1
  3. package/dist/_chunks/{inbound-request-gJ5wpsBF.mjs → inbound-request-xmrm-49O.mjs} +0 -1
  4. package/dist/_chunks/{principal-69qoDdqy.mjs → principal-DMNXj4PX.mjs} +1 -1
  5. package/dist/extension/hooks/authorization.mjs +1 -1
  6. package/dist/extension/instructions.md +4 -19
  7. package/dist/extension/lib/actor.mjs +1 -1
  8. package/dist/extension/lib/attachment-tools.mjs +1 -1
  9. package/dist/extension/lib/build-metadata.mjs +1 -1
  10. package/dist/extension/lib/confirmation-description.d.ts +5 -0
  11. package/dist/extension/lib/confirmation-description.mjs +11 -3
  12. package/dist/extension/lib/confirmations.d.ts +1 -1
  13. package/dist/extension/lib/confirmations.mjs +3 -1
  14. package/dist/extension/lib/conversation-runtime.mjs +15 -2
  15. package/dist/extension/lib/group-routing/observed.mjs +1 -1
  16. package/dist/extension/lib/group-routing/router.d.ts +8 -2
  17. package/dist/extension/lib/group-routing/router.mjs +4 -2
  18. package/dist/extension/lib/ontology-connection.mjs +1 -1
  19. package/dist/extension/lib/ontology-file-call.mjs +1 -1
  20. package/dist/extension/lib/ontology-tools.d.ts +1 -1
  21. package/dist/extension/lib/ontology-tools.mjs +1 -1
  22. package/dist/extension/lib/runtime-envelope.mjs +1 -1
  23. package/dist/extension/lib/stored-files.d.ts +23 -8
  24. package/dist/extension/lib/stored-files.mjs +54 -43
  25. package/dist/extension/lib/telegram/adapter.mjs +11 -50
  26. package/dist/extension/lib/telegram/attachment-description.mjs +1 -1
  27. package/dist/extension/lib/telegram/attachments-send.mjs +2 -2
  28. package/dist/extension/lib/telegram/callbacks.mjs +2 -2
  29. package/dist/extension/lib/telegram/confirmations.d.ts +1 -2
  30. package/dist/extension/lib/telegram/confirmations.mjs +3 -11
  31. package/dist/extension/lib/telegram/conversations.mjs +2 -2
  32. package/dist/extension/lib/telegram/customer-text.mjs +1 -1
  33. package/dist/extension/lib/telegram/durable-typing.mjs +1 -1
  34. package/dist/extension/lib/telegram/files.mjs +2 -2
  35. package/dist/extension/lib/telegram/health.mjs +1 -1
  36. package/dist/extension/lib/telegram/held-approvals.d.ts +5 -2
  37. package/dist/extension/lib/telegram/held-approvals.mjs +1 -2
  38. package/dist/extension/lib/telegram/images.mjs +1 -1
  39. package/dist/extension/lib/telegram/inbound-request.d.ts +0 -2
  40. package/dist/extension/lib/telegram/inbound-request.mjs +1 -1
  41. package/dist/extension/lib/telegram/inbound.d.ts +0 -2
  42. package/dist/extension/lib/telegram/inbound.mjs +10 -9
  43. package/dist/extension/lib/telegram/lifecycle.mjs +3 -3
  44. package/dist/extension/lib/telegram/media-policy.mjs +1 -1
  45. package/dist/extension/lib/telegram/principal.mjs +1 -1
  46. package/dist/extension/lib/telegram/session-recovery.mjs +1 -1
  47. package/dist/extension/lib/telegram/sessions.d.ts +8 -0
  48. package/dist/extension/lib/telegram/sessions.mjs +21 -1
  49. package/dist/extension/lib/telegram/silent.mjs +2 -2
  50. package/dist/extension/lib/telegram/structured.mjs +1 -1
  51. package/dist/extension/lib/telegram/turn-errors.mjs +2 -2
  52. package/dist/extension/lib/telegram/voice.mjs +1 -1
  53. package/dist/extension/model.mjs +1 -1
  54. package/dist/extension/tools/attachments_promote.mjs +1 -1
  55. package/dist/extension/tools/attachments_stage.d.ts +2 -1
  56. package/dist/extension/tools/attachments_stage.mjs +53 -20
  57. package/dist/extension/tools/questions_ask.mjs +1 -1
  58. package/package.json +1 -1
  59. package/dist/extension/lib/confirmation-outcome.d.ts +0 -27
  60. package/dist/extension/lib/confirmation-outcome.mjs +0 -34
  61. package/dist/extension/lib/deferred-confirmations.d.ts +0 -41
  62. package/dist/extension/lib/deferred-confirmations.mjs +0 -77
  63. package/dist/extension/lib/telegram/confirmation-expiry.d.ts +0 -5
  64. package/dist/extension/lib/telegram/confirmation-expiry.mjs +0 -62
  65. package/dist/extension/lib/telegram/deferred-confirmations.d.ts +0 -26
  66. package/dist/extension/lib/telegram/deferred-confirmations.mjs +0 -295
  67. package/dist/extension/schedules/confirmations.d.ts +0 -6
  68. package/dist/extension/schedules/confirmations.mjs +0 -33
@@ -1,295 +0,0 @@
1
- import { fileURLToPath as __eveFileURLToPath } from "node:url";
2
- import { dirname as __eveDirname } from "node:path";
3
- import { createRequire as __eveCreateRequire } from "node:module";
4
- const __filename = __eveFileURLToPath(import.meta.url);
5
- __eveDirname(__filename);
6
- __eveCreateRequire(import.meta.url);
7
- import { telegramText, withTelegramLocale } from "./texts.mjs";
8
- import { o as telegramPrincipal } from "../../../_chunks/principal-69qoDdqy.mjs";
9
- import { humanText } from "../confirmation-description.mjs";
10
- import { renderConfirmation, withConfirmationText } from "./confirmation-text.mjs";
11
- import { chatPostCard, chatPostCardStatus, chatPostReceipt, withChatPostCard } from "./chat-post-card.mjs";
12
- import { conversationEvent } from "../conversations.mjs";
13
- import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.mjs";
14
- import { agentMessage, observedChatKey, withConfirmationPrompt } from "../group-routing/observed.mjs";
15
- import { CONFIRMATION_TTL_MS, inputHash } from "../confirmations.mjs";
16
- import { OntologyToolRejected } from "../ontology-tools.mjs";
17
- import { formatAddress } from "./sessions.mjs";
18
- import { confirmationOutcome } from "../confirmation-outcome.mjs";
19
- import { deferredConfirmations, deferredKey, runDeferredAction } from "../deferred-confirmations.mjs";
20
- import { telegramTextLinks } from "@segmentstream-cloud/ontology/telegram";
21
- const PREFIX = "ss-confirm:d:";
22
- const isDeferredCallback = (data) => data?.startsWith(PREFIX) === true;
23
- const deferredCallback = (record, choice) => `${PREFIX}${record.key}:${choice}`;
24
- const copyOf = (record) => withTelegramLocale(record.data.locale, () => record.data.confirmation.description?.chatPost ? chatPostCard(record.data.confirmation.description, record.data.confirmation.copy) : renderConfirmation(record.data.confirmation.description, record.data.confirmation.copy));
25
- function promptOf(record, state) {
26
- const name = humanText(record.data.requesterName);
27
- return {
28
- mode: "deferred",
29
- requestId: record.id,
30
- sessionId: record.data.sessionId,
31
- address: record.data.address,
32
- action: humanText(record.data.confirmation.description?.action) ?? "",
33
- requestedBy: name ?? null,
34
- at: new Date(record.expiresAt - CONFIRMATION_TTL_MS).toISOString(),
35
- state,
36
- ...name === void 0 ? {} : { requester: {
37
- id: record.data.requester,
38
- author: name
39
- } }
40
- };
41
- }
42
- function remember(record, text, prompt, observed) {
43
- if (record.data.messageId === void 0) return;
44
- observed?.remember(observedChatKey({
45
- chatId: record.data.chatId,
46
- ...record.data.threadId ? { messageThreadId: Number(record.data.threadId) } : {}
47
- }), {
48
- ...agentMessage({
49
- text,
50
- at: new Date().toISOString(),
51
- messageId: record.data.messageId,
52
- ...prompt.requester === void 0 ? {} : { inReplyTo: prompt.requester }
53
- }),
54
- confirmation: prompt
55
- });
56
- }
57
- async function archiveDeferred(record, phase, archive, errorText) {
58
- await archive.append(conversationEvent({
59
- eventId: `confirmation:${record.id}:${phase}`,
60
- provider: "telegram",
61
- chatId: record.data.chatId,
62
- threadId: record.data.threadId || null,
63
- chatType: record.data.chatId.startsWith("-") ? "group" : "private",
64
- participantIds: [record.memberId],
65
- kind: "tool_result",
66
- sessionId: record.data.sessionId,
67
- toolCallId: record.id,
68
- operationId: record.id,
69
- toolName: record.data.action,
70
- reason: phase,
71
- ...errorText === void 0 ? {} : { errorText },
72
- status: phase === "done" ? "completed" : phase === "failed" ? "failed" : phase === "cancelled" || phase === "expired" ? "cancelled" : "requested"
73
- }));
74
- }
75
- async function postDeferredCard(id, channel, ctx, options, archive, observed) {
76
- const store = deferredConfirmations(options);
77
- const record = await store.command({
78
- operation: "read",
79
- key: deferredKey(id)
80
- });
81
- if (!record || record.data.sessionId !== ctx.session.id || record.status !== "pending" || record.data.messageId) return;
82
- const copy = copyOf(record);
83
- const address = channel.continuation?.token ?? formatAddress({
84
- chatId: record.data.chatId,
85
- messageThreadId: record.data.threadId,
86
- conversationId: channel.telegram.conversationId ?? ""
87
- });
88
- const prompt = {
89
- ...promptOf(record, "pending"),
90
- address
91
- };
92
- await archiveDeferred(record, "requested", archive);
93
- const post = () => channel.telegram.post({
94
- text: copy.text,
95
- reply_markup: { inline_keyboard: [[
96
- {
97
- text: copy.confirm,
98
- callback_data: deferredCallback(record, "y")
99
- },
100
- ...record.data.confirmation.description?.chatPost ? [{
101
- text: copy.edit,
102
- callback_data: deferredCallback(record, "e")
103
- }] : [],
104
- {
105
- text: copy.cancel,
106
- callback_data: deferredCallback(record, "n")
107
- }
108
- ]] }
109
- });
110
- const sent = await withConfirmationPrompt(prompt, () => record.data.confirmation.description?.chatPost ? withChatPostCard(copy.text, post, copy.previewLinks) : withConfirmationText(copy.text, post));
111
- await store.command({
112
- operation: "attach",
113
- key: record.key,
114
- messageId: sent.id,
115
- address
116
- });
117
- remember({
118
- ...record,
119
- data: {
120
- ...record.data,
121
- messageId: sent.id,
122
- address
123
- }
124
- }, copy.text, prompt, observed);
125
- }
126
- async function editCard(record, context, status, state, observed) {
127
- if (!record.data.messageId) return;
128
- const copy = copyOf(record);
129
- const exact = record.data.confirmation.description?.chatPost !== void 0;
130
- const text = exact ? chatPostCardStatus(copy.text, status) : `${copy.text}\n\n${status}`;
131
- const edit = () => context.telegram.editMessageText({
132
- messageId: record.data.messageId,
133
- text,
134
- replyMarkup: { inline_keyboard: [] }
135
- });
136
- const prompt = promptOf(record, state);
137
- await withConfirmationPrompt(prompt, () => exact ? withChatPostCard(text, edit, [...copy.previewLinks ?? [], ...telegramTextLinks(status)]) : withConfirmationText(text, edit));
138
- remember(record, text, prompt, observed);
139
- }
140
- async function handleDeferredCallback(input) {
141
- const { query, context, options, archive } = input;
142
- const notice = async (text) => {
143
- try {
144
- await context.telegram.answerCallbackQuery({
145
- callbackQueryId: query.id,
146
- text,
147
- showAlert: false
148
- });
149
- } catch (error) {
150
- reportTelegramError("deferred_acknowledgment_failed", error);
151
- }
152
- };
153
- const parts = /^ss-confirm:d:([0-9a-f]{20}):([yne])$/.exec(query.data ?? "");
154
- if (!parts || !query.message || query.from.isBot) {
155
- await notice(telegramText("callback", "unknown"));
156
- return;
157
- }
158
- const store = deferredConfirmations(options);
159
- const record = await store.command({
160
- operation: "read",
161
- key: parts[1]
162
- });
163
- const lookup = await input.identities.lookup({
164
- provider: "telegram",
165
- externalId: query.from.id
166
- });
167
- if (!record || lookup.status !== "paired" || lookup.member.id !== record.memberId || record.data.requester !== query.from.id || record.data.chatId !== query.message.chat.id || record.data.threadId !== String(query.message.messageThreadId ?? "") || record.data.messageId !== query.message.messageId) {
168
- await notice(telegramText("callback", "forbidden"));
169
- return;
170
- }
171
- if (record.inputHash !== inputHash(record.data.input) || parts[2] === "e" && record.data.confirmation.description?.chatPost === void 0) {
172
- await notice(telegramText("callback", "unknown"));
173
- return;
174
- }
175
- const copy = copyOf(record);
176
- const decision = parts[2] === "y" ? "approve" : "cancel";
177
- const claimed = await store.command({
178
- operation: "decide",
179
- key: record.key,
180
- memberId: record.memberId,
181
- inputHash: inputHash(record.data.input),
182
- decision
183
- });
184
- if (!claimed || claimed.status === "pending") {
185
- await notice(telegramText("callback", "already"));
186
- return;
187
- }
188
- await notice(claimed.status === "expired" ? telegramText("callback", "expired") : void 0);
189
- let status = claimed.status;
190
- let cardStatus = status === "expired" ? copy.expired : copy.cancelled;
191
- let execution;
192
- let failure;
193
- try {
194
- await archiveDeferred(claimed, claimed.status, archive);
195
- } catch (error) {
196
- const reference = reportTelegramError("deferred_decision_archive_failed", error);
197
- if (status === "approved") {
198
- status = "failed";
199
- execution = "not_started";
200
- cardStatus = `${copy.failed} ${reference}`;
201
- await store.command({
202
- operation: "finish",
203
- key: claimed.key,
204
- status
205
- });
206
- }
207
- }
208
- if (status === "approved") {
209
- try {
210
- await editCard(claimed, context, copy.executing, "approved", input.observed);
211
- } catch (error) {
212
- reportTelegramError("deferred_card_update_failed", error);
213
- }
214
- try {
215
- const result = await runDeferredAction(claimed, options);
216
- status = "done";
217
- cardStatus = claimed.data.confirmation.description?.chatPost ? withTelegramLocale(claimed.data.locale, () => chatPostReceipt(result.structuredContent) ?? telegramText("chatPost", "uncertain") ?? "") : copy.completed;
218
- } catch (error) {
219
- status = "failed";
220
- const reference = reportTelegramError("deferred_action_failed", error);
221
- failure = error instanceof OntologyToolRejected ? {
222
- code: error.code,
223
- message: error.message.slice(0, 4096)
224
- } : {
225
- code: "deferred_action_failed",
226
- message: reference
227
- };
228
- if (!(error instanceof OntologyToolRejected)) execution = "uncertain";
229
- cardStatus = `${copy.failed} ${reference}`;
230
- }
231
- await store.command({
232
- operation: "finish",
233
- key: claimed.key,
234
- status
235
- });
236
- }
237
- if (status === "done" || status === "failed") try {
238
- await archiveDeferred(claimed, status, archive, failure?.message);
239
- } catch (error) {
240
- reportTelegramError("deferred_outcome_archive_failed", error);
241
- }
242
- try {
243
- await editCard(claimed, context, cardStatus, status === "done" ? "completed" : status, input.observed);
244
- } catch (error) {
245
- reportTelegramError("deferred_card_update_failed", error);
246
- }
247
- const principal = telegramPrincipal({
248
- member: lookup.member,
249
- message: {
250
- ...query.message,
251
- from: query.from,
252
- text: "",
253
- caption: "",
254
- raw: {},
255
- attachments: []
256
- }
257
- });
258
- await currentInboundRequest()?.confirmationEvent?.(claimed, confirmationOutcome(claimed, status, {
259
- ...execution === void 0 ? {} : { execution },
260
- ...failure === void 0 ? {} : { error: failure },
261
- ...parts[2] === "e" && status === "cancelled" ? { editRequested: true } : {}
262
- }), principal);
263
- }
264
- async function expireDeferredRecord(record, context, options, archive, notify, observed) {
265
- const claimed = await deferredConfirmations(options).command({
266
- operation: "decide",
267
- key: record.key,
268
- memberId: record.memberId,
269
- inputHash: record.inputHash,
270
- decision: "expire"
271
- });
272
- if (!claimed) return;
273
- try {
274
- await archiveDeferred(claimed, "expired", archive);
275
- } catch (error) {
276
- reportTelegramError("deferred_outcome_archive_failed", error);
277
- }
278
- try {
279
- await editCard(claimed, context, copyOf(claimed).expired, "expired", observed);
280
- } catch (error) {
281
- reportTelegramError("deferred_card_update_failed", error);
282
- }
283
- await notify(claimed, confirmationOutcome(claimed, "expired"), null);
284
- }
285
- async function expireDeferredCards(context, options, archive, observed) {
286
- const records = await deferredConfirmations(options).command({
287
- operation: "expired",
288
- chatId: context.telegram.chatId
289
- });
290
- for (const record of records) {
291
- if (record.data.threadId !== String(context.telegram.messageThreadId ?? "")) continue;
292
- await expireDeferredRecord(record, context, options, archive, async (saved, result, auth) => currentInboundRequest()?.confirmationEvent?.(saved, result, auth), observed);
293
- }
294
- }
295
- export { archiveDeferred, deferredCallback, expireDeferredCards, expireDeferredRecord, handleDeferredCallback, isDeferredCallback, postDeferredCard };
@@ -1,6 +0,0 @@
1
- /** No model is invoked until an actual expiry outcome is delivered to its original chat. */
2
- declare const _default: {
3
- cron: string;
4
- run({ to }: import("eve/schedules").ScheduleHandlerArgs): Promise<void>;
5
- };
6
- export default _default;
@@ -1,33 +0,0 @@
1
- import { fileURLToPath as __eveFileURLToPath } from "node:url";
2
- import { dirname as __eveDirname } from "node:path";
3
- import { createRequire as __eveCreateRequire } from "node:module";
4
- const __filename = __eveFileURLToPath(import.meta.url);
5
- __eveDirname(__filename);
6
- __eveCreateRequire(import.meta.url);
7
- import { channelsEnabled } from "../lib/environment.mjs";
8
- import segmentstream from "../extension.mjs";
9
- import telegram_default from "../channels/telegram.mjs";
10
- import { expireScheduledConfirmations } from "../lib/telegram/confirmation-expiry.mjs";
11
- import { defineSchedule } from "eve/schedules";
12
- var confirmations_default = defineSchedule({
13
- cron: "* * * * *",
14
- async run({ to }) {
15
- const settings = segmentstream.config.channels.telegram;
16
- if (!channelsEnabled(process.env) || !settings) return;
17
- await expireScheduledConfirmations(settings.connection, async (record, result) => {
18
- await to(telegram_default, {
19
- chatId: record.data.chatId,
20
- messageThreadId: record.data.threadId ? Number(record.data.threadId) : void 0,
21
- confirmationAddress: record.data.address,
22
- confirmationSessionId: record.data.sessionId
23
- }).send(JSON.stringify({
24
- type: "confirmation_result",
25
- ...result
26
- }), {
27
- auth: null,
28
- turnPolicy: "queue"
29
- });
30
- }, {}, settings, segmentstream.config.texts);
31
- }
32
- });
33
- export { confirmations_default as default };