@segmentstream/agent 0.14.0 → 0.15.0

package/README.md

@@ -549,7 +549,7 @@ Eve resolution, so member/topic routing survives a cold start. No second provide
 
 ## Release and migration
 
-The coordinated release uses Agent SDK 0.14.0, Eve 0.76.3, Ontology SDK 0.50.0 and App SDK 0.24.1.
+The coordinated release uses Agent SDK 0.15.0, Eve 0.76.3, Ontology SDK 0.50.1 and App SDK 0.24.1.
 The compatible Cloud archive/API must be deployed first; migrations run only through its CI/CD gate.
 Publish the ontology SDK before the agent SDK. Upgrade the workspace ontology before its agent,
 with the declared Telegram provider mapping and explicit `agent_chat:post_message` grant.
@@ -651,3 +651,9 @@ reports the effective confirmation mode and attachment-lifecycle presence behind
 runtime authentication; source pins and public health alone are not settings-adoption proof.
 
 Telegram 0.13.0 requires workspace-authored pairing and confirmation text. See [workspace Telegram text](../../docs/agent.md#workspace-telegram-text) for keys, limits, neutral fallbacks and unsupported Eve buttons.
+
+Workspace [callback actions](../../docs/agent.md#workspace-callback-actions) and
+[structured Telegram input](../../docs/agent.md#structured-telegram-input) are separate opt-in
+mappings. They require the ontology runtime-source capability and dispatch only a currently
+permitted routine action as the verified member. The workspace owns callback tokens, presentation
+and business idempotency.

package/dist/_chunks/{build-metadata-BB2uSGsI.mjs → build-metadata-CJlaXNhc.mjs}

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-var version = "0.14.0";
+var version = "0.15.0";
 function agentBuild(environment = process.env) {
 	return {
 		agent: version,

package/dist/_chunks/{inbound-request-BXhiIph-.mjs → inbound-request-RIRNBxUC.mjs}

@@ -256,6 +256,9 @@ var InboundRequest = class {
 	claimTurn;
 	beginDispatch;
 	finishClaim;
+	structuredContext;
+	recordStructuredContext;
+	beginStructuredContinuation;
 	locale;
 	threadId;
 	text;

package/dist/_chunks/{principal-VFQWqe5S.mjs → principal-MEMlG3EG.mjs}

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { n as currentInboundRequest } from "./inbound-request-BXhiIph-.mjs";
+import { n as currentInboundRequest } from "./inbound-request-RIRNBxUC.mjs";
 import { randomUUID } from "node:crypto";
 function telegramRuntimeSource(message, files, callbackQueryId) {
 	const attachments = [];

package/dist/extension/config.d.ts

@@ -1,5 +1,6 @@
 import { type GroupPolicyInput } from "@segmentstream-cloud/ontology/groups";
 import { type GroupPolicy } from "./lib/group-routing/policy.js";
+import { type StructuredInbound } from "./lib/telegram/structured-settings.js";
 import type { WorkspaceActionHook } from "./lib/telegram/workspace-action.js";
 import { type TelegramTexts } from "./lib/telegram/texts.js";
 import type { AttachmentLifecycle } from "./lib/telegram/lifecycle.js";
@@ -76,6 +77,10 @@ export interface SegmentStreamAgentConfigInput {
             readonly linkPreviews?: string;
             /** Additional exact HTTP(S) origins belonging to this workspace. */
             readonly additionalOwnOrigins?: readonly string[];
+            readonly inbound?: Omit<StructuredInbound, "contextVersion" | "kinds"> & {
+                readonly kinds: ReadonlyArray<string>;
+                readonly contextVersion: number;
+            };
             readonly callbacks?: Omit<WorkspaceActionHook, "contextVersion"> & {
                 readonly contextVersion: number;
             };
@@ -138,6 +143,7 @@ export interface TelegramSettings {
         readonly topicScope?: boolean;
         readonly commandsAddress?: boolean;
     };
+    readonly inbound?: StructuredInbound;
     readonly callbacks?: WorkspaceActionHook;
     readonly connection: string;
     readonly policy: TelegramPolicy;

package/dist/extension/config.mjs

@@ -6,6 +6,7 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { effectiveGroupPolicy, groupPolicy } from "./lib/group-routing/policy.mjs";
 import { localizedText as localizedText$1 } from "./lib/admission.mjs";
+import { STRUCTURED_KINDS } from "./lib/telegram/structured-settings.mjs";
 import { TELEGRAM_TEXT_KEYS } from "./lib/telegram/texts.mjs";
 import { isTechnicalText } from "./lib/customer-text-safety.mjs";
 import { readFileSync, realpathSync } from "node:fs";
@@ -80,7 +81,8 @@ function telegramSettings(value, issues) {
 			"additionalOwnOrigins",
 			"attachmentLifecycle",
 			"menuButton",
-			"callbacks"
+			"callbacks",
+			"inbound"
 		],
 		issues
 	});
@@ -123,6 +125,30 @@ function telegramSettings(value, issues) {
 		message: "must be an array of HTTP(S) origins without paths, credentials, queries or fragments",
 		path: [...path, "additionalOwnOrigins"]
 	});
+	const inboundConfig = section({
+		value: telegram.inbound,
+		path: [...path, "inbound"],
+		allowed: [
+			"entity",
+			"action",
+			"kinds",
+			"contextVersion"
+		],
+		issues
+	});
+	const inbound = inboundConfig === void 0 ? void 0 : workspaceHook({
+		entity: inboundConfig.entity,
+		action: inboundConfig.action,
+		contextVersion: inboundConfig.contextVersion
+	}, [...path, "inbound"], issues);
+	if (inboundConfig !== void 0 && (!Array.isArray(inboundConfig.kinds) || inboundConfig.kinds.length === 0 || inboundConfig.kinds.length > 3 || new Set(inboundConfig.kinds).size !== inboundConfig.kinds.length || !inboundConfig.kinds.every((kind) => STRUCTURED_KINDS.includes(kind)))) issues.push({
+		message: "must be distinct location, venue or contact kinds",
+		path: [
+			...path,
+			"inbound",
+			"kinds"
+		]
+	});
 	const callbacks = workspaceHook(telegram.callbacks, [...path, "callbacks"], issues);
 	const menuButton = section({
 		value: telegram.menuButton,
@@ -162,6 +188,10 @@ function telegramSettings(value, issues) {
 		policy,
 		...signalSettings === void 0 ? {} : { groups: signalSettings },
 		...callbacks === void 0 ? {} : { callbacks },
+		...inbound === void 0 ? {} : { inbound: {
+			...inbound,
+			kinds: inboundConfig.kinds
+		} },
 		linkPreviews,
 		additionalOwnOrigins,
 		...menuText === void 0 ? {} : { menuButton: { text: menuText } },

package/dist/extension/hooks/authorization.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { localizedText } from "../lib/admission.mjs";
-import "../../_chunks/principal-VFQWqe5S.mjs";
+import "../../_chunks/principal-MEMlG3EG.mjs";
 import { confirmationLocale } from "../lib/telegram/confirmation-text.mjs";
 import segmentstream from "../extension.mjs";
 import { defineHook } from "eve/hooks";

package/dist/extension/lib/attachment-tools.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin } from "./environment.mjs";
-import { i as memberIdOf } from "../../_chunks/principal-VFQWqe5S.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
 import { runtimeToken } from "./runtime-token.mjs";
 import { agentAttachments } from "./attachments.mjs";
 import { telegramConversation } from "./telegram/files.mjs";

package/dist/extension/lib/build-metadata.mjs

@@ -4,5 +4,5 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { t as agentBuild } from "../../_chunks/build-metadata-BB2uSGsI.mjs";
+import { t as agentBuild } from "../../_chunks/build-metadata-CJlaXNhc.mjs";
 export { agentBuild };

package/dist/extension/lib/confirmations.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { withTelegramTexts } from "./telegram/texts.mjs";
-import { i as memberIdOf } from "../../_chunks/principal-VFQWqe5S.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
 import { confirmationCopy, confirmationLocale, renderConfirmation } from "./telegram/confirmation-text.mjs";
 import { chatPostCard } from "./telegram/chat-post-card.mjs";
 import { chatPostDigest, isChatPost } from "./chat-post-confirmation.mjs";

package/dist/extension/lib/conversation-runtime.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { ENDS_CONVERSATION_INSTRUCTIONS } from "./group-routing/conversation-prompt.mjs";
-import { i as memberIdOf } from "../../_chunks/principal-VFQWqe5S.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
 import { n as contentText, t as CONTENT_CAPS } from "../../_chunks/content-CvFsrmSD.mjs";
 import { conversationEvent, conversations, summarizeArguments } from "./conversations.mjs";
 import { parseAddress } from "./telegram/sessions.mjs";

package/dist/extension/lib/deferred-confirmations.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin } from "./environment.mjs";
-import { i as memberIdOf, l as principalRuntimeSource, u as runtimeEnvelope } from "../../_chunks/principal-VFQWqe5S.mjs";
+import { i as memberIdOf, l as principalRuntimeSource, u as runtimeEnvelope } from "../../_chunks/principal-MEMlG3EG.mjs";
 import { redactDiagnostic } from "./diagnostics.mjs";
 import { humanText, object } from "./confirmation-description.mjs";
 import { runtimeToken } from "./runtime-token.mjs";

package/dist/extension/lib/ontology-connection.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin } from "./environment.mjs";
-import { c as compatibleRuntimeEnvelope, i as memberIdOf, r as identityProviderOf, u as runtimeEnvelope } from "../../_chunks/principal-VFQWqe5S.mjs";
+import { c as compatibleRuntimeEnvelope, i as memberIdOf, r as identityProviderOf, u as runtimeEnvelope } from "../../_chunks/principal-MEMlG3EG.mjs";
 import { runtimeToken, tokenExpiry } from "./runtime-token.mjs";
 import { CHAT_POST_ENVELOPE, chatPostDigest, chatPostOperationId, isChatPost } from "./chat-post-confirmation.mjs";
 import { actionApproval, confirmations } from "./confirmations.mjs";

package/dist/extension/lib/ontology-gateway.mjs

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { i as memberIdOf, u as runtimeEnvelope } from "../../_chunks/principal-VFQWqe5S.mjs";
+import { i as memberIdOf, u as runtimeEnvelope } from "../../_chunks/principal-MEMlG3EG.mjs";
 import { object } from "./confirmation-description.mjs";
 import { readOntologyMetadata } from "./ontology-metadata-read.mjs";
 async function ontologyMetadata(memberId, operation, input, context, options = {}) {

package/dist/extension/lib/ontology-metadata-read.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin } from "./environment.mjs";
-import { i as memberIdOf } from "../../_chunks/principal-VFQWqe5S.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
 import { redactDiagnostic } from "./diagnostics.mjs";
 import { object } from "./confirmation-description.mjs";
 import { OntologyToolRejected, ontologyTools } from "./ontology-tools.mjs";

package/dist/extension/lib/ontology-tools.d.ts

@@ -18,6 +18,8 @@ export declare function ontologyTools(options?: {
     readonly environment?: Environment;
     readonly token?: RuntimeToken;
     readonly fetch?: typeof fetch;
+    /** Install a durable dispatch fence after safe metadata/auth work, immediately before the action request. */
+    readonly beforeCall?: (name: string) => Promise<void>;
 }): {
     rpc: (memberId: string, method: string, params: Record<string, unknown>, signal?: AbortSignal) => Promise<Record<string, unknown>>;
     list(memberId: string): Promise<Record<string, unknown>[]>;

package/dist/extension/lib/ontology-tools.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin } from "./environment.mjs";
-import { c as compatibleRuntimeEnvelope, i as memberIdOf, r as identityProviderOf, s as RUNTIME_SOURCE_PROTOCOL, u as runtimeEnvelope } from "../../_chunks/principal-VFQWqe5S.mjs";
+import { c as compatibleRuntimeEnvelope, i as memberIdOf, r as identityProviderOf, s as RUNTIME_SOURCE_PROTOCOL, u as runtimeEnvelope } from "../../_chunks/principal-MEMlG3EG.mjs";
 import { redactDiagnostic } from "./diagnostics.mjs";
 import { describeConfirmation, object } from "./confirmation-description.mjs";
 import { runtimeToken } from "./runtime-token.mjs";
@@ -34,6 +34,7 @@ function ontologyTools(options = {}) {
 		const provider = memberIdOf(options.principal) === memberId ? identityProviderOf(options.principal) : void 0;
 		const credential = await (options.token ?? runtimeToken)();
 		const secrets = new Set([credential]);
+		if (method === "tools/call") await options.beforeCall?.(String(params.name));
 		try {
 			const response = await (options.fetch ?? fetch)(`${appOrigin(options.environment ?? process.env)}/mcp`, {
 				method: "POST",

package/dist/extension/lib/runtime-envelope.mjs

@@ -4,5 +4,5 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { c as compatibleRuntimeEnvelope, d as telegramRuntimeSource, l as principalRuntimeSource, s as RUNTIME_SOURCE_PROTOCOL, u as runtimeEnvelope } from "../../_chunks/principal-VFQWqe5S.mjs";
+import { c as compatibleRuntimeEnvelope, d as telegramRuntimeSource, l as principalRuntimeSource, s as RUNTIME_SOURCE_PROTOCOL, u as runtimeEnvelope } from "../../_chunks/principal-MEMlG3EG.mjs";
 export { RUNTIME_SOURCE_PROTOCOL, compatibleRuntimeEnvelope, principalRuntimeSource, runtimeEnvelope, telegramRuntimeSource };

package/dist/extension/lib/stored-files.mjs

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { i as memberIdOf } from "../../_chunks/principal-VFQWqe5S.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
 import { redactDiagnostic } from "./diagnostics.mjs";
 import { object } from "./confirmation-description.mjs";
 import { ontologyTools } from "./ontology-tools.mjs";

package/dist/extension/lib/telegram/adapter.mjs

@@ -7,19 +7,20 @@ __eveCreateRequire(import.meta.url);
 import { telegramText, withTelegramTexts } from "./texts.mjs";
 import { manifestOf } from "../../config.mjs";
 import { appOrigin, channelsEnabled, proxyEnvironment, runtimeIdentityEnvironment, webhookSecret } from "../environment.mjs";
-import { n as conversationLanguage, o as telegramPrincipal } from "../../../_chunks/principal-VFQWqe5S.mjs";
+import { n as conversationLanguage, o as telegramPrincipal } from "../../../_chunks/principal-MEMlG3EG.mjs";
 import { confirmationLocale } from "./confirmation-text.mjs";
 import { telegramSendScope } from "./send-queue.mjs";
-import { d as failureText, h as withDeliveryLocale, i as withReplacedText, m as safeTelegramFetch, n as currentInboundRequest, o as currentLocale, p as reportTelegramError, r as runInboundRequest, t as InboundRequest } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
+import { d as failureText, h as withDeliveryLocale, i as withReplacedText, m as safeTelegramFetch, n as currentInboundRequest, o as currentLocale, p as reportTelegramError, r as runInboundRequest, t as InboundRequest } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
 import { chooseModel } from "../../model.mjs";
 import { groupRoutingHealth } from "../group-routing/health.mjs";
 import { decisionRouter } from "../group-routing/router.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
 import { conversations } from "../conversations.mjs";
 import { archivedRoutingMessages } from "../group-routing/routing-context.mjs";
+import { dispatchStructuredMessage, structuredMessage } from "./structured.mjs";
 import { scopedAddress, sessionPolicy } from "./sessions.mjs";
 import { handleWorkspaceCallback, isWorkspaceCallback } from "./callbacks.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-BB2uSGsI.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-CJlaXNhc.mjs";
 import { attachmentLifecycle } from "./lifecycle.mjs";
 import { observedMessages } from "./observed.mjs";
 import { expireDeferredCards, handleDeferredCallback, isDeferredCallback } from "./deferred-confirmations.mjs";
@@ -122,6 +123,10 @@ function segmentstreamTelegram(options) {
 		identities: pairing,
 		observed,
 		chats,
+		structured: (raw) => {
+			const inbound = settings().inbound;
+			return inbound === void 0 ? void 0 : structuredMessage(raw, inbound.kinds);
+		},
 		verify: telegramWebhookVerifier(() => webhookSecret(environment)),
 		answerCallback: async (callbackQueryId, locale) => {
 			const text = telegramText("callback", "unsupported", locale);
@@ -204,6 +209,20 @@ function segmentstreamTelegram(options) {
 							includeDecisions: true
 						})).events, 100),
 						signalSettings: settings().groups,
+						...settings().inbound === void 0 ? {} : { structured: {
+							configuration: settings().inbound,
+							run: (principal, memberId, message, event, beforeDispatch) => dispatchStructuredMessage({
+								configuration: settings().inbound,
+								principal,
+								memberId,
+								message,
+								event,
+								beforeDispatch,
+								environment,
+								token,
+								...options.fetch ? { fetch: options.fetch } : {}
+							})
+						} },
 						recoverHeldApprovals: options.confirmationMode?.() === "deferred",
 						...settings().attachmentLifecycle === void 0 ? {} : { lifecycle: (principal, memberId, message) => attachmentLifecycle({
 							configuration: settings().attachmentLifecycle,
@@ -297,7 +316,7 @@ function segmentstreamTelegram(options) {
 					reportTelegramError("intake_dispatch_release_failed", cleanupError);
 				}
 				const errorId = reportTelegramError("inbound_message_failed", error, { chatId: message.chat.id });
-				if (inbound?.retryReference !== void 0 || inbound?.lifecycleKey !== void 0) inbound.retryReference = errorId;
+				if (inbound?.retryReference !== void 0 || inbound?.lifecycleKey !== void 0 || inbound?.structuredContext !== void 0) inbound.retryReference = errorId;
 				else await context.telegram.post(failureText(errorId));
 				return null;
 			} finally {

package/dist/extension/lib/telegram/attachment-description.mjs

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
 import { describableImage } from "./images.mjs";
 import { MAXIMUM_ROUTING_PDF_CHARACTERS, extractRoutingPdf } from "./pdf-text.mjs";
 import { gateway, generateText } from "ai";

package/dist/extension/lib/telegram/attachments-send.mjs

@@ -5,11 +5,11 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin, channelsEnabled, proxyEnvironment } from "../environment.mjs";
-import "../../../_chunks/principal-VFQWqe5S.mjs";
+import "../../../_chunks/principal-MEMlG3EG.mjs";
 import { redactDiagnostic } from "../diagnostics.mjs";
 import { confirmationLocale } from "./confirmation-text.mjs";
 import { inTelegramSendQueue, telegramSendScope } from "./send-queue.mjs";
-import { d as failureText, f as formattingRefused, l as customerMessage, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
+import { d as failureText, f as formattingRefused, l as customerMessage, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
 import { MAXIMUM_PROXY_BODY_BYTES, connectionProxy } from "../connection-proxy.mjs";
 import { ACT_AS_HEADER } from "../ontology-connection.mjs";

package/dist/extension/lib/telegram/callbacks.mjs

@@ -6,11 +6,11 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { admitMessage } from "../admission.mjs";
 import { telegramText } from "./texts.mjs";
-import { d as telegramRuntimeSource, i as memberIdOf, o as telegramPrincipal, u as runtimeEnvelope } from "../../../_chunks/principal-VFQWqe5S.mjs";
+import { d as telegramRuntimeSource, i as memberIdOf, o as telegramPrincipal, u as runtimeEnvelope } from "../../../_chunks/principal-MEMlG3EG.mjs";
 import { object } from "../confirmation-description.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
-import { formatAddress, parseAddress, scopedAddress } from "./sessions.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
 import { workspaceAction } from "./workspace-action.mjs";
+import { formatAddress, parseAddress, scopedAddress } from "./sessions.mjs";
 const isWorkspaceCallback = (data) => data?.startsWith("ws:") === true;
 async function handleWorkspaceCallback(input) {
 	const { query, context } = input;

package/dist/extension/lib/telegram/confirmation-expiry.mjs

@@ -7,7 +7,7 @@ __eveCreateRequire(import.meta.url);
 import { withTelegramTexts } from "./texts.mjs";
 import { proxyEnvironment } from "../environment.mjs";
 import { telegramSendScope } from "./send-queue.mjs";
-import { m as safeTelegramFetch, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
+import { m as safeTelegramFetch, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
 import { conversations } from "../conversations.mjs";
 import { deferredConfirmations } from "../deferred-confirmations.mjs";

package/dist/extension/lib/telegram/confirmations.mjs

@@ -5,16 +5,16 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { telegramText } from "./texts.mjs";
-import { i as memberIdOf, o as telegramPrincipal } from "../../../_chunks/principal-VFQWqe5S.mjs";
+import { i as memberIdOf, o as telegramPrincipal } from "../../../_chunks/principal-MEMlG3EG.mjs";
 import { humanText } from "../confirmation-description.mjs";
 import { renderConfirmation, withConfirmationText } from "./confirmation-text.mjs";
 import { chatPostCard, chatPostCardStatus, chatPostReceipt, withChatPostCard } from "./chat-post-card.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
 import { agentMessage, observedChatKey, withConfirmationPrompt } from "../group-routing/observed.mjs";
 import { conversationEvent } from "../conversations.mjs";
-import { formatAddress, scopedAddress } from "./sessions.mjs";
 import { chatPostOperationId, isChatPost } from "../chat-post-confirmation.mjs";
 import { confirmations } from "../confirmations.mjs";
+import { formatAddress, scopedAddress } from "./sessions.mjs";
 import { postDeferredCard } from "./deferred-confirmations.mjs";
 import { answerMarker, isPendingQuestion, pendingQuestions, questionKey } from "../questions.mjs";
 import { createHash } from "node:crypto";

package/dist/extension/lib/telegram/conversations.d.ts

@@ -1,3 +1,4 @@
+import type { StructuredMessage } from "./structured.js";
 import type { AgentIdentities } from "../identities.js";
 import { type Conversations } from "../conversations.js";
 import type { AgentChats } from "./chats.js";
@@ -9,6 +10,7 @@ export declare const REVISION_CLAIM_TTL_MS: number;
 /** Runs after webhook verification, before eve drops bot/channel/service updates. */
 export declare function captureTelegramWebhook(input: {
     readonly answerCallback?: (id: string, locale?: string) => Promise<unknown>;
+    readonly structured?: (raw: Readonly<Record<string, unknown>>) => StructuredMessage | undefined;
     readonly request: Request;
     readonly archive: Conversations;
     readonly identities: AgentIdentities;
@@ -33,6 +35,7 @@ export declare function conversationIdentities(identities: AgentIdentities): Age
 /** Verification and failure acknowledgement stay outside eve's swallowed onMessage failures. */
 export declare function telegramConversationCapture(input: {
     readonly answerCallback?: (id: string, locale?: string) => Promise<unknown>;
+    readonly structured?: (raw: Readonly<Record<string, unknown>>) => StructuredMessage | undefined;
     readonly archive: Conversations;
     readonly identities: () => AgentIdentities;
     readonly observed: ObservedMessages;

package/dist/extension/lib/telegram/conversations.mjs

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { n as currentInboundRequest, p as reportTelegramError, s as currentThreadId } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
+import { n as currentInboundRequest, p as reportTelegramError, s as currentThreadId } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
 import { currentConfirmationPrompt, observedChatKey } from "../group-routing/observed.mjs";
 import { conversationEvent } from "../conversations.mjs";
 import { archivedRoutingMessages } from "../group-routing/routing-context.mjs";
@@ -108,6 +108,7 @@ async function captureTelegramWebhook(input) {
 	if (parsed?.kind !== "message") return input.next();
 	const message = parsed.message;
 	const content = messageContent(message.raw);
+	const structured = input.structured?.(message.raw);
 	const time = edited === void 0 ? message.raw.date : message.raw.edit_date ?? message.raw.date;
 	const sentAt = typeof time === "number" ? time * 1e3 : Date.now();
 	const senderChat = record(message.raw.sender_chat);
@@ -158,8 +159,10 @@ async function captureTelegramWebhook(input) {
 	const revisionId = edited === void 0 ? void 0 : `telegram:${message.chat.id}:${message.messageId}:routing:${createHash("sha256").update(JSON.stringify({
 		at: event.at,
 		content,
+		...structured === void 0 ? {} : { structured },
 		...event.attachments.length === 0 ? {} : { attachments: attachmentIdentity(event.attachments) }
 	})).digest("hex")}`;
+	const dispatchKey = `telegram:${message.chat.id}:${message.messageId}` + (structured === void 0 ? "" : `:structured:${revisionId ?? "initial"}`);
 	const revisionEvents = [];
 	let revisionClaim;
 	const finishRevision = async (status) => {
@@ -197,12 +200,31 @@ async function captureTelegramWebhook(input) {
 		...lookup?.status === "paired" ? { participantId: lookup.member.id } : {}
 	})).events;
 	const routing = messageHistory.filter((earlier) => earlier.kind === "decision" && earlier.senderId === event.senderId);
-	const previousClaim = routing.find((earlier) => earlier.reason === "turn_claimed");
-	const admitted = routing.some((earlier) => earlier.reason === "turn_admitted");
-	const released = previousClaim !== void 0 && routing.some((earlier) => earlier.eventId === `${previousClaim.eventId}:released`);
-	const dispatched = routing.some((earlier) => earlier.reason === "turn_dispatch_started");
+	const dispatchHistory = structured === void 0 ? routing : routing.filter((earlier) => earlier.eventId.startsWith(`${dispatchKey}:`));
+	const previousClaim = dispatchHistory.find((earlier) => earlier.reason === "turn_claimed");
+	const admitted = dispatchHistory.some((earlier) => earlier.reason === "turn_admitted");
+	const released = previousClaim !== void 0 && dispatchHistory.some((earlier) => earlier.eventId === `${previousClaim.eventId}:released`);
+	const dispatched = dispatchHistory.some((earlier) => earlier.reason === "turn_dispatch_started");
 	const reserved = previousClaim !== void 0 && !released && Date.now() - Date.parse(previousClaim.at) < 6e5;
-	const alreadyHandled = admitted || dispatched || reserved;
+	const result = dispatchHistory.find((earlier) => earlier.reason === "structured_action_completed" && earlier.status === "completed");
+	let structuredContext;
+	if (structured !== void 0 && result?.argsSummary && lookup === void 0 && message.from !== void 0 && !message.from.isBot) {
+		lookup = await input.identities.lookup({
+			provider: "telegram",
+			externalId: message.from.id
+		});
+		capture.lookup = lookup;
+	}
+	if (structured !== void 0 && lookup?.status === "paired" && result?.argsSummary) try {
+		const value = record(JSON.parse(result.argsSummary));
+		if (typeof value.memberId === "string" && value.memberId === lookup.member.id && typeof value.context === "string" && value.context.trim() && value.context.length <= 16384) structuredContext = {
+			text: value.context,
+			memberId: value.memberId
+		};
+	} catch {}
+	const continuationDispatched = dispatchHistory.some((earlier) => earlier.reason === "structured_context_dispatch_started");
+	const continuationPending = dispatched && structuredContext !== void 0 && !admitted && !continuationDispatched;
+	const alreadyHandled = (admitted || dispatched || reserved) && !continuationPending;
 	const rememberRevision = (events) => {
 		if (revisionId !== void 0) revisionEvents.push(...events.filter((item) => item.eventId === revisionId || item.eventId.startsWith(`${revisionId}:`)));
 	};
@@ -282,8 +304,9 @@ async function captureTelegramWebhook(input) {
 	}
 	let accepted = false;
 	if (inbound !== void 0) {
-		inbound.edited = edited !== void 0;
-		if (revisionId !== void 0) inbound.claimRevision = async () => {
+		inbound.structuredContext = continuationPending ? structuredContext : void 0;
+		inbound.edited = edited !== void 0 && !continuationPending;
+		if (revisionId !== void 0 && !continuationPending) inbound.claimRevision = async () => {
 			if (revisionEvents.some((item) => item.eventId === `${revisionId}:completed`)) return false;
 			const claims = revisionEvents.filter((item) => item.reason === "routing_claimed");
 			const latest = claims[0];
@@ -305,9 +328,9 @@ async function captureTelegramWebhook(input) {
 			return inserted !== false;
 		};
 		const nextClaim = previousClaim === void 0 ? void 0 : createHash("sha256").update(previousClaim.eventId).digest("hex");
-		const claimId = previousClaim === void 0 ? `telegram:${message.chat.id}:${message.messageId}:turn` : `telegram:${message.chat.id}:${message.messageId}:turn:${nextClaim}`;
-		let claimed = false;
-		let dispatchStarted = false;
+		const claimId = continuationPending && previousClaim !== void 0 ? previousClaim.eventId : previousClaim === void 0 ? `${dispatchKey}:turn` : `${dispatchKey}:turn:${nextClaim}`;
+		let claimed = continuationPending;
+		let dispatchStarted = continuationPending;
 		const claimEvent = (reason, status, suffix = "") => ({
 			...capture.event,
 			eventId: `${claimId}${suffix}`,
@@ -327,10 +350,32 @@ async function captureTelegramWebhook(input) {
 		inbound.beginDispatch = async () => {
 			dispatchStarted = await input.archive.append({
 				...claimEvent("turn_dispatch_started", "requested"),
-				eventId: `telegram:${message.chat.id}:${message.messageId}:dispatch`
+				eventId: `${dispatchKey}:dispatch`
 			}) === true;
 			return dispatchStarted;
 		};
+		inbound.recordStructuredContext = async (context, memberId) => {
+			if (await input.archive.append({
+				...claimEvent("structured_action_completed", "completed"),
+				eventId: `${dispatchKey}:result`,
+				argsSummary: JSON.stringify({
+					context,
+					memberId
+				})
+			}) !== true) throw new Error("The archive did not acknowledge the structured continuation.");
+			inbound.structuredContext = {
+				text: context,
+				memberId
+			};
+		};
+		inbound.beginStructuredContinuation = async () => {
+			const inserted = await input.archive.append({
+				...claimEvent("structured_context_dispatch_started", "requested"),
+				eventId: `${dispatchKey}:context-dispatch`
+			});
+			dispatchStarted ||= inserted === true;
+			return inserted === true;
+		};
 		inbound.finishClaim = async (delivered) => {
 			if ((accepted || dispatchStarted) && !delivered) return;
 			accepted ||= delivered;

package/dist/extension/lib/telegram/customer-text.mjs

@@ -5,5 +5,5 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { isTechnicalText } from "../customer-text-safety.mjs";
-import { a as TelegramDeliveryError, c as customerCopy, d as failureText, f as formattingRefused, h as withDeliveryLocale, l as customerMessage, m as safeTelegramFetch, o as currentLocale, p as reportTelegramError, s as currentThreadId, u as customerText } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
+import { a as TelegramDeliveryError, c as customerCopy, d as failureText, f as formattingRefused, h as withDeliveryLocale, l as customerMessage, m as safeTelegramFetch, o as currentLocale, p as reportTelegramError, s as currentThreadId, u as customerText } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
 export { TelegramDeliveryError, currentLocale, currentThreadId, customerCopy, customerMessage, customerText, failureText, formattingRefused, isTechnicalText, reportTelegramError, safeTelegramFetch, withDeliveryLocale };

package/dist/extension/lib/telegram/deferred-confirmations.mjs

@@ -5,16 +5,16 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { telegramText, withTelegramLocale } from "./texts.mjs";
-import { o as telegramPrincipal } from "../../../_chunks/principal-VFQWqe5S.mjs";
+import { o as telegramPrincipal } from "../../../_chunks/principal-MEMlG3EG.mjs";
 import { humanText } from "../confirmation-description.mjs";
 import { renderConfirmation, withConfirmationText } from "./confirmation-text.mjs";
 import { chatPostCard, chatPostCardStatus, chatPostReceipt, withChatPostCard } from "./chat-post-card.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
 import { agentMessage, observedChatKey, withConfirmationPrompt } from "../group-routing/observed.mjs";
 import { conversationEvent } from "../conversations.mjs";
-import { formatAddress } from "./sessions.mjs";
 import { CONFIRMATION_TTL_MS, inputHash } from "../confirmations.mjs";
 import { OntologyToolRejected } from "../ontology-tools.mjs";
+import { formatAddress } from "./sessions.mjs";
 import { confirmationOutcome } from "../confirmation-outcome.mjs";
 import { deferredConfirmations, deferredKey, runDeferredAction } from "../deferred-confirmations.mjs";
 import { telegramTextLinks } from "@segmentstream-cloud/ontology/telegram";

package/dist/extension/lib/telegram/files.mjs

@@ -4,8 +4,8 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { n as conversationLanguage } from "../../../_chunks/principal-VFQWqe5S.mjs";
-import { d as failureText, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
+import { n as conversationLanguage } from "../../../_chunks/principal-MEMlG3EG.mjs";
+import { d as failureText, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
 import { describableImage, describeReceivedImage } from "./images.mjs";
 import { MAXIMUM_ATTACHMENT_BYTES, attachmentUrl } from "../attachments.mjs";
 function telegramConversation(chatId) {

package/dist/extension/lib/telegram/health.mjs

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { t as agentBuild } from "../../../_chunks/build-metadata-BB2uSGsI.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-CJlaXNhc.mjs";
 import { runtimeRequestFailure } from "./runtime-request.mjs";
 import { GET } from "eve/channels";
 const HEALTH_ROUTE = "/eve/v1/telegram/health";