@xopcai/xopc 0.0.188 → 0.0.189

package/dist/src/agent/external-tools/endpoint-provider.js

@@ -0,0 +1,93 @@
+import { externalToolRef, parseExternalToolRef } from "./refs.js";
+//#region src/agent/external-tools/endpoint-provider.ts
+function contentText(content) {
+	if (content.type === "text") return content.text;
+	if (content.type === "json") return JSON.stringify(content.value, null, 2);
+	return `[File: ${content.name}, ${content.mimeType}, ${content.size} bytes, id=${content.fileId}]`;
+}
+var EndpointToolProvider = class {
+	source = "endpoint";
+	constructor(deps) {
+		this.deps = deps;
+	}
+	async search(_query) {
+		const endpoint = this.currentEndpoint();
+		if (!endpoint) return [];
+		return endpoint.tools.map(({ descriptor }) => ({
+			toolRef: externalToolRef(this.source, endpoint.endpointId, descriptor.name),
+			source: this.source,
+			namespace: endpoint.endpointId,
+			title: descriptor.title,
+			summary: `${descriptor.description} (${endpoint.displayName})`
+		}));
+	}
+	async describe(toolRef) {
+		const resolved = this.resolve(toolRef);
+		if (!resolved) return void 0;
+		return {
+			toolRef,
+			source: this.source,
+			namespace: resolved.endpointId,
+			title: resolved.tool.descriptor.title,
+			summary: `${resolved.tool.descriptor.description} (${resolved.displayName})`,
+			description: resolved.tool.descriptor.description,
+			inputSchema: resolved.tool.descriptor.inputSchema
+		};
+	}
+	async execute(toolRef, args, _approvalId, context) {
+		const resolved = this.resolve(toolRef);
+		if (!resolved) throw new Error(`Endpoint tool is unavailable for this turn: ${toolRef}`);
+		const result = await this.deps.runtime.invocations.invoke({
+			endpointId: resolved.endpointId,
+			toolCallId: context.toolCallId,
+			toolName: resolved.tool.descriptor.name,
+			arguments: args,
+			descriptorRevision: resolved.tool.revision,
+			signal: context.signal,
+			onProgress: (progress) => {
+				context.onUpdate?.({
+					content: [{
+						type: "text",
+						text: progress.message ?? "Endpoint tool is running"
+					}],
+					details: {
+						endpointId: resolved.endpointId,
+						...progress.percent === void 0 ? {} : { percent: progress.percent }
+					}
+				});
+			}
+		});
+		const files = result.content.filter((item) => item.type === "file");
+		return {
+			content: result.content.map((item) => ({
+				type: "text",
+				text: contentText(item)
+			})),
+			details: {
+				endpointId: resolved.endpointId,
+				endpointToolName: resolved.tool.descriptor.name,
+				...result.details ?? {},
+				...files.length === 0 ? {} : { endpointFiles: files }
+			}
+		};
+	}
+	currentEndpoint() {
+		const origin = this.deps.getCurrentContext()?.origin;
+		if (origin?.type !== "endpoint") return void 0;
+		return this.deps.runtime.registry.get(origin.endpointId);
+	}
+	resolve(toolRef) {
+		const parsed = parseExternalToolRef(toolRef, this.source);
+		if (!parsed) return void 0;
+		const endpoint = this.currentEndpoint();
+		if (!endpoint || endpoint.endpointId !== parsed.namespace) return void 0;
+		const tool = this.deps.runtime.registry.getTool(endpoint.endpointId, parsed.toolName);
+		return tool ? {
+			endpointId: endpoint.endpointId,
+			displayName: endpoint.displayName,
+			tool
+		} : void 0;
+	}
+};
+//#endregion
+export { EndpointToolProvider };

package/dist/src/agent/external-tools/gateway-tools.js

@@ -44,7 +44,7 @@ function createExternalToolGatewayTools(providers) {
 		{
 			name: EXTERNAL_TOOL_NAMES.search,
 			label: "🔎 External Tool Search",
-			description: "Search MCP, connected-app, extension, and remote-memory tools. Use concise English capability keywords. Returns compact references only; call xopc_tool_describe before execution.",
+			description: "Search MCP, connected-app, extension, remote-memory, and current-endpoint tools. Use concise English capability keywords. Returns compact references only; call xopc_tool_describe before execution.",
 			parameters: ToolSearchSchema,
 			async execute(_toolCallId, params) {
 				return textResult(await service.search(params));

package/dist/src/agent/external-tools/index.d.ts

@@ -2,15 +2,14 @@ import type { Config } from '../../config/schema.js';
 import type { ExtensionHookRunner } from '../../extensions/index.js';
 import type { ExtensionRegistry } from '../../extensions/types/index.js';
 import type { MemoryManager } from '../memory/manager.js';
+import type { EndpointToolRuntime } from '../../endpoint-tools/index.js';
 import type { ToolExecutorConfig } from '../tools/executor.js';
+import type { ExternalToolTurnContext } from './types.js';
 export interface DefaultExternalToolGatewayDeps {
     workspace: string;
     getConfig: () => Config | undefined;
-    getCurrentContext: () => {
-        channel: string;
-        chatId: string;
-        sessionKey: string;
-    } | null;
+    getCurrentContext: () => ExternalToolTurnContext | null;
+    endpointTools?: EndpointToolRuntime;
     agentId?: string;
     extensionRegistry?: ExtensionRegistry;
     disabledTools?: Set<string>;

package/dist/src/agent/external-tools/index.js

@@ -4,9 +4,10 @@ import { ExternalToolService } from "./service.js";
 import { EXTERNAL_TOOL_NAMES, createExternalToolGatewayTools } from "./gateway-tools.js";
 import { McpToolProvider } from "./mcp-provider.js";
 import { MemoryToolProvider } from "./memory-provider.js";
+import { EndpointToolProvider } from "./endpoint-provider.js";
 //#region src/agent/external-tools/index.ts
 function createDefaultExternalToolGatewayTools(deps) {
-	return createExternalToolGatewayTools([
+	const providers = [
 		new McpToolProvider({
 			workspace: deps.workspace,
 			getConfig: deps.getConfig,
@@ -34,7 +35,12 @@ function createDefaultExternalToolGatewayTools(deps) {
 			hookRunner: deps.hookRunner,
 			toolExecutorConfig: deps.toolExecutorConfig
 		})
-	]);
+	];
+	if (deps.endpointTools) providers.push(new EndpointToolProvider({
+		runtime: deps.endpointTools,
+		getCurrentContext: deps.getCurrentContext
+	}));
+	return createExternalToolGatewayTools(providers);
 }
 //#endregion
 export { EXTERNAL_TOOL_NAMES, ExternalToolService, createDefaultExternalToolGatewayTools };

package/dist/src/agent/external-tools/types.d.ts

@@ -1,5 +1,6 @@
 import type { AgentToolResult, AgentToolUpdateCallback } from '@earendil-works/pi-agent-core';
-export declare const EXTERNAL_TOOL_SOURCES: readonly ["mcp", "composio", "extension", "memory"];
+import type { TurnOrigin } from '@xopcai/endpoint-tools-protocol';
+export declare const EXTERNAL_TOOL_SOURCES: readonly ["mcp", "composio", "extension", "memory", "endpoint"];
 export type ExternalToolSource = (typeof EXTERNAL_TOOL_SOURCES)[number];
 export interface ExternalToolSearchHit {
     toolRef: string;
@@ -20,6 +21,12 @@ export interface ExternalToolExecutionContext {
     signal?: AbortSignal;
     onUpdate?: AgentToolUpdateCallback<Record<string, unknown>>;
 }
+export interface ExternalToolTurnContext {
+    channel: string;
+    chatId: string;
+    sessionKey: string;
+    origin: TurnOrigin;
+}
 export interface ExternalToolProvider {
     readonly source: ExternalToolSource;
     search(query: string): Promise<ExternalToolSearchHit[]>;

package/dist/src/agent/external-tools/types.js

@@ -3,7 +3,8 @@ const EXTERNAL_TOOL_SOURCES = [
 	"mcp",
 	"composio",
 	"extension",
-	"memory"
+	"memory",
+	"endpoint"
 ];
 //#endregion
 export { EXTERNAL_TOOL_SOURCES };

package/dist/src/agent/inbound/inbound-loop.js

@@ -83,6 +83,10 @@ var InboundLoop = class {
 				chatId: context.chatId,
 				senderId: context.senderId || "",
 				isGroup: context.isGroup || false,
+				origin: {
+					type: "channel",
+					channel: context.channel
+				},
 				metadata: { transcribedVoice: msg.metadata?.transcribedVoice === true }
 			};
 			const sessionMetadata = await this.cfg.sessionStore.getMetadata(sessionContext.sessionKey).catch(() => null);

package/dist/src/agent/inbound/turn-dispatcher.d.ts

@@ -4,7 +4,7 @@
  * Wraps the two existing direct-turn runners (one-shot and streaming) so the
  * parent `AgentService` no longer carries a pair of huge `createXxxDeps()`
  * factories. The public surface — `processDirect`, `processDirectStreaming`,
- * `steerWebchatSession`, `enqueueWebchatSseEvent`,
+ * `steerWebchatSession`, `enqueueWebchatStreamEvent`,
  * `notifyWebchatTranscriptAppend` — matches what `AgentService` exposed
  * previously, so callers (gateway, CLI) are unchanged.
  *
@@ -14,6 +14,7 @@
  * that wires those dependencies together; individual responsibilities now live
  * in their own classes and are unit-testable.
  */
+import type { TurnOrigin } from '@xopcai/endpoint-tools-protocol';
 import type { Config } from '../../config/schema.js';
 import type { ContextualLogger } from '../../utils/logger/types.js';
 import type { AgentManager } from '../agent-manager.js';
@@ -23,7 +24,7 @@ import type { SessionConfigStore } from '../../session/index.js';
 import type { SessionStore } from '../../session/store.js';
 import type { SessionContext, SessionHydrator, SessionStateBag } from '../session/index.js';
 import type { InboundAttachmentInput, MediaRef } from '../../channels/attachments/inbound-persist.js';
-import { type ProcessDirectStreamingSseEvent } from '../service/process-direct-streaming.js';
+import { type ProcessDirectStreamEvent } from '../service/process-direct-streaming.js';
 import type { AgentSourceContextResolver } from '../source-context/types.js';
 export interface TurnDispatcherConfig {
     log: ContextualLogger;
@@ -41,7 +42,7 @@ export interface TurnDispatcherConfig {
         chatId: string;
     }>;
     /** Establish per-session context (also creates the Agent + subscribes to events). */
-    initSessionContext: (sessionKey: string, channel: string, chatId: string) => SessionContext;
+    initSessionContext: (sessionKey: string, channel: string, chatId: string, origin: TurnOrigin) => SessionContext;
     /** Per-session config hydration: workspace, model, thinking. */
     sessionHydrator: SessionHydrator;
     prepareInboundAttachments: (sessionKey: string, attachments?: InboundAttachmentInput[]) => Promise<MediaRef[] | undefined>;
@@ -67,14 +68,14 @@ export declare class TurnDispatcher {
     private readonly log;
     constructor(cfg: TurnDispatcherConfig);
     /** One-shot direct turn (CLI / embedded TUI). */
-    processDirect(content: string, sessionKey?: string, attachments?: DirectAttachment[], thinking?: string, options?: ProcessDirectOptions): Promise<string>;
-    /** Streaming direct turn (webchat SSE / CLI streaming). */
-    processDirectStreaming(content: string, sessionKey?: string, attachments?: DirectAttachment[], thinking?: string, options?: {
+    processDirect(content: string, sessionKey: string, origin: TurnOrigin, attachments?: DirectAttachment[], thinking?: string, options?: ProcessDirectOptions): Promise<string>;
+    /** Streaming direct turn (webchat realtime / CLI streaming). */
+    processDirectStreaming(content: string, sessionKey: string, origin: TurnOrigin, attachments?: DirectAttachment[], thinking?: string, options?: {
         signal?: AbortSignal;
         runId?: string;
-    }): AsyncGenerator<ProcessDirectStreamingSseEvent, void, unknown>;
+    }): AsyncGenerator<ProcessDirectStreamEvent, void, unknown>;
     /** Push an out-of-band event into the live webchat stream for a session. */
-    enqueueWebchatSseEvent(sessionKey: string, event: {
+    enqueueWebchatStreamEvent(sessionKey: string, event: {
         type: string;
         [key: string]: unknown;
     }): void;

package/dist/src/agent/inbound/turn-dispatcher.js

@@ -12,10 +12,11 @@ var TurnDispatcher = class {
 		this.log = cfg.log;
 	}
 	/** One-shot direct turn (CLI / embedded TUI). */
-	processDirect(content, sessionKey = "agent:main:main", attachments, thinking, options) {
+	processDirect(content, sessionKey, origin, attachments, thinking, options) {
 		return runProcessDirect(this.buildOneShotDeps(), {
 			content,
 			sessionKey,
+			origin,
 			attachments,
 			thinking,
 			signal: options?.signal,
@@ -23,11 +24,12 @@ var TurnDispatcher = class {
 			deadlineAtMs: options?.deadlineAtMs
 		});
 	}
-	/** Streaming direct turn (webchat SSE / CLI streaming). */
-	async *processDirectStreaming(content, sessionKey = "agent:main:main", attachments, thinking, options) {
+	/** Streaming direct turn (webchat realtime / CLI streaming). */
+	async *processDirectStreaming(content, sessionKey, origin, attachments, thinking, options) {
 		yield* runProcessDirectStreaming(this.buildStreamingDeps(), {
 			content,
 			sessionKey,
+			origin,
 			attachments,
 			thinking,
 			signal: options?.signal,
@@ -35,7 +37,7 @@ var TurnDispatcher = class {
 		});
 	}
 	/** Push an out-of-band event into the live webchat stream for a session. */
-	enqueueWebchatSseEvent(sessionKey, event) {
+	enqueueWebchatStreamEvent(sessionKey, event) {
 		const pub = this.cfg.sessionState.getWebchatPublisher(sessionKey);
 		if (pub) pub(event);
 	}
@@ -51,15 +53,15 @@ var TurnDispatcher = class {
 				}],
 				timestamp: Date.now()
 			};
-			this.enqueueWebchatSseEvent(sessionKey, {
+			this.enqueueWebchatStreamEvent(sessionKey, {
 				type: "message_start",
 				message
 			});
-			this.enqueueWebchatSseEvent(sessionKey, {
+			this.enqueueWebchatStreamEvent(sessionKey, {
 				type: "message_update",
 				message
 			});
-			this.enqueueWebchatSseEvent(sessionKey, {
+			this.enqueueWebchatStreamEvent(sessionKey, {
 				type: "message_end",
 				message
 			});
@@ -90,8 +92,8 @@ var TurnDispatcher = class {
 			log: this.log,
 			resolveSessionEndpoint: c.resolveSessionEndpoint,
 			initDirectStreamingSession: c.initSessionContext,
-			registerWebchatSsePublisher: (sk, publisher) => c.sessionState.registerWebchatPublisher(sk, publisher),
-			unregisterWebchatSsePublisher: (sk) => c.sessionState.unregisterWebchatPublisher(sk),
+			registerWebchatStreamPublisher: (sk, publisher) => c.sessionState.registerWebchatPublisher(sk, publisher),
+			unregisterWebchatStreamPublisher: (sk) => c.sessionState.unregisterWebchatPublisher(sk),
 			agentManager: c.agentManager,
 			hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),
 			hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),
@@ -139,8 +141,8 @@ var TurnDispatcher = class {
 			log: this.log,
 			config: cfg,
 			resolveSessionEndpoint: c.resolveSessionEndpoint,
-			initSessionContext: (sk, channel, chatId) => {
-				c.initSessionContext(sk, channel, chatId);
+			initSessionContext: (sk, channel, chatId, origin) => {
+				c.initSessionContext(sk, channel, chatId, origin);
 			},
 			hydrateSessionWorkspaceFromStore: (sk) => c.sessionHydrator.workspace(sk),
 			hydrateSessionModelFromStore: (sk) => c.sessionHydrator.model(sk),

package/dist/src/agent/messaging/command-handler.d.ts

@@ -75,7 +75,7 @@ export declare class CommandHandler {
     updateAgentConfig(config: Config): void;
     /**
      * Build the unified command context shared by all execute paths.
-     * When `recorder` is set, every reply text is also captured (for SSE / CLI aggregation).
+     * When `recorder` is set, every reply text is also captured (for realtime / CLI aggregation).
      */
     private buildCommandContext;
     /**
@@ -83,7 +83,7 @@ export declare class CommandHandler {
      */
     executeCommand(commandName: string, args: string, context: CommandContext): Promise<boolean>;
     /**
-     * Run command and return all user-visible text (ctx.reply + result.content) for SSE/CLI.
+     * Run command and return all user-visible text (ctx.reply + result.content) for realtime/CLI.
      * Same bus side effects as {@link executeCommand}.
      */
     executeCommandAndAggregateReply(commandName: string, args: string, context: CommandContext, options?: {

package/dist/src/agent/messaging/command-handler.js

@@ -8,7 +8,7 @@ import "../../chat-commands/index.js";
 init_providers();
 init_logger();
 const log = createLogger("CommandHandler");
-/** Gateway console direct stream uses SSE tokens; there is no ChannelPlugin outbound for `webchat`. */
+/** Gateway console direct stream uses realtime events; there is no ChannelPlugin outbound for `webchat`. */
 function shouldSkipBusOutboundForChannel(channel) {
 	return channel === "webchat";
 }
@@ -53,7 +53,7 @@ var CommandHandler = class {
 	}
 	/**
 	* Build the unified command context shared by all execute paths.
-	* When `recorder` is set, every reply text is also captured (for SSE / CLI aggregation).
+	* When `recorder` is set, every reply text is also captured (for realtime / CLI aggregation).
 	*/
 	buildCommandContext(context, recorder, emitEvent) {
 		const skipBusOutbound = shouldSkipBusOutboundForChannel(context.channel);
@@ -162,7 +162,7 @@ var CommandHandler = class {
 		return true;
 	}
 	/**
-	* Run command and return all user-visible text (ctx.reply + result.content) for SSE/CLI.
+	* Run command and return all user-visible text (ctx.reply + result.content) for realtime/CLI.
 	* Same bus side effects as {@link executeCommand}.
 	*/
 	async executeCommandAndAggregateReply(commandName, args, context, options) {

package/dist/src/agent/service/async-queue.d.ts

@@ -2,7 +2,7 @@
  * Async FIFO queue with `for await` support.
  *
  * Replaces the ad-hoc `eventQueue + resolveWaiting` single-slot pattern that
- * the streaming direct turn used to manage SSE events. The previous pattern was
+ * the streaming direct turn used to manage run events. The previous pattern was
  * lossy if two pushes landed before the single waiter resumed; this queue keeps
  * the buffer growing until consumed, and closes cleanly so the iterator drains.
  */

package/dist/src/agent/service/async-queue.js

@@ -3,7 +3,7 @@
 * Async FIFO queue with `for await` support.
 *
 * Replaces the ad-hoc `eventQueue + resolveWaiting` single-slot pattern that
-* the streaming direct turn used to manage SSE events. The previous pattern was
+* the streaming direct turn used to manage run events. The previous pattern was
 * lossy if two pushes landed before the single waiter resumed; this queue keeps
 * the buffer growing until consumed, and closes cleanly so the iterator drains.
 */

package/dist/src/agent/service/direct-turn-helpers.d.ts

@@ -1,6 +1,6 @@
 /**
  * Shared building blocks for the two direct-turn entry points (streaming
- * webchat SSE and one-shot CLI). Both flows do the same hydrate → maybe-slash
+ * webchat realtime and one-shot CLI). Both flows do the same hydrate → maybe-slash
  * → run-embedded-turn → after-turn dance; this module captures that core so
  * the entry points only manage their I/O specifics (event sink, voice STT,
  * TTS, transcript persistence).

package/dist/src/agent/service/direct-turn-helpers.js

@@ -12,7 +12,7 @@ import crypto from "node:crypto";
 //#region src/agent/service/direct-turn-helpers.ts
 /**
 * Shared building blocks for the two direct-turn entry points (streaming
-* webchat SSE and one-shot CLI). Both flows do the same hydrate → maybe-slash
+* webchat realtime and one-shot CLI). Both flows do the same hydrate → maybe-slash
 * → run-embedded-turn → after-turn dance; this module captures that core so
 * the entry points only manage their I/O specifics (event sink, voice STT,
 * TTS, transcript persistence).

package/dist/src/agent/service/process-direct-one-shot.d.ts

@@ -1,3 +1,4 @@
+import type { TurnOrigin } from '@xopcai/endpoint-tools-protocol';
 import type { CommandHandler } from '../messaging/command-handler.js';
 import type { AgentInstanceGateway } from '../agent-instance-gateway.js';
 import type { ModelManager } from '../models/index.js';
@@ -12,7 +13,7 @@ export type RunProcessDirectDeps = {
         channel: string;
         chatId: string;
     }>;
-    initSessionContext: (sessionKey: string, channel: string, chatId: string) => void;
+    initSessionContext: (sessionKey: string, channel: string, chatId: string, origin: TurnOrigin) => void;
     hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;
     hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;
     agentManager: AgentInstanceGateway;
@@ -31,6 +32,7 @@ export type RunProcessDirectDeps = {
 export declare function runProcessDirect(deps: RunProcessDirectDeps, input: {
     content: string;
     sessionKey: string;
+    origin: TurnOrigin;
     attachments?: InboundAttachmentInput[];
     thinking?: string;
     signal?: AbortSignal;

package/dist/src/agent/service/process-direct-one-shot.js

@@ -9,7 +9,7 @@ function isReviewOutput(value) {
 }
 async function runProcessDirect(deps, input) {
 	const { channel, chatId } = await deps.resolveSessionEndpoint(input.sessionKey);
-	deps.initSessionContext(input.sessionKey, channel, chatId);
+	deps.initSessionContext(input.sessionKey, channel, chatId, input.origin);
 	try {
 		let turnBody = input.content;
 		let resetTriggeredAtInit = false;

package/dist/src/agent/service/process-direct-streaming.d.ts

@@ -1,3 +1,4 @@
+import type { TurnOrigin } from '@xopcai/endpoint-tools-protocol';
 import type { Config } from '../../config/schema.js';
 import type { InboundAttachmentInput, MediaRef } from '../../channels/attachments/inbound-persist.js';
 import { type SessionConfigStore, type SessionStore } from '../../session/index.js';
@@ -19,12 +20,12 @@ export interface ProcessDirectStreamingDeps {
         channel: string;
         chatId: string;
     }>;
-    initDirectStreamingSession: (sessionKey: string, channel: string, chatId: string) => SessionContext;
-    registerWebchatSsePublisher: (sessionKey: string, publisher: (event: {
+    initDirectStreamingSession: (sessionKey: string, channel: string, chatId: string, origin: TurnOrigin) => SessionContext;
+    registerWebchatStreamPublisher: (sessionKey: string, publisher: (event: {
         type: string;
         [key: string]: unknown;
     }) => void) => void;
-    unregisterWebchatSsePublisher: (sessionKey: string) => void;
+    unregisterWebchatStreamPublisher: (sessionKey: string) => void;
     agentManager: AgentInstanceGateway;
     hydrateSessionWorkspaceFromStore: (sessionKey: string) => Promise<void>;
     hydrateSessionModelFromStore: (sessionKey: string) => Promise<void>;
@@ -59,13 +60,14 @@ export interface ProcessDirectStreamingDeps {
 export interface ProcessDirectStreamingInput {
     content: string;
     sessionKey?: string;
+    origin: TurnOrigin;
     attachments?: DirectStreamInboundAttachment[];
     thinking?: string;
     signal?: AbortSignal;
     runId?: string;
 }
-export type ProcessDirectStreamingSseEvent = {
+export type ProcessDirectStreamEvent = {
     type: string;
     [key: string]: unknown;
 };
-export declare function runProcessDirectStreaming(deps: ProcessDirectStreamingDeps, input: ProcessDirectStreamingInput): AsyncGenerator<ProcessDirectStreamingSseEvent, void, unknown>;
+export declare function runProcessDirectStreaming(deps: ProcessDirectStreamingDeps, input: ProcessDirectStreamingInput): AsyncGenerator<ProcessDirectStreamEvent, void, unknown>;

package/dist/src/agent/service/process-direct-streaming.js

@@ -8,7 +8,7 @@ import { mergeSttConfigFromAppConfig } from "../../voice/stt/config.js";
 import "../../voice/stt/index.js";
 import { abortEmbeddedRun } from "../embedded/runs.js";
 import { isVoiceLikeAttachment, mergeVoiceTranscriptsIntoUserText } from "../../channels/attachments/voice-stt-webchat.js";
-import { applyReasoningVisibilityToSseEvent } from "../streaming/reasoning-visibility-sse.js";
+import { applyReasoningVisibility } from "../streaming/reasoning-visibility.js";
 import { injectSourceContextIntoUserMessage } from "../source-context/injector.js";
 import { isSessionSourceBinding } from "../source-context/types.js";
 import { AsyncQueue } from "./async-queue.js";
@@ -117,11 +117,11 @@ function pushAssistantReceipt(queue, text, runId, metadata) {
 async function* runProcessDirectStreaming(deps, input) {
 	const sessionKey = input.sessionKey ?? "agent:main:main";
 	const { channel, chatId } = await deps.resolveSessionEndpoint(sessionKey);
-	const context = deps.initDirectStreamingSession(sessionKey, channel, chatId);
+	const context = deps.initDirectStreamingSession(sessionKey, channel, chatId, input.origin);
 	const queue = new AsyncQueue();
 	let reasoningLevel = channel === "webchat" ? resolveConfiguredActivityDetailDefault(deps.getConfig()) : "stream";
 	const pushVisible = (event) => {
-		const visible = channel === "webchat" ? event : applyReasoningVisibilityToSseEvent(event, reasoningLevel);
+		const visible = channel === "webchat" ? event : applyReasoningVisibility(event, reasoningLevel);
 		if (visible !== null) queue.push(visible);
 	};
 	const formatStreamError = (raw) => {
@@ -136,7 +136,7 @@ async function* runProcessDirectStreaming(deps, input) {
 			modelRef
 		});
 	};
-	if (channel === "webchat") deps.registerWebchatSsePublisher(sessionKey, pushVisible);
+	if (channel === "webchat") deps.registerWebchatStreamPublisher(sessionKey, pushVisible);
 	const signal = input.signal;
 	let userAborted = false;
 	let abortHandled = false;
@@ -352,7 +352,7 @@ async function* runProcessDirectStreaming(deps, input) {
 		}
 		deps.recordTaskReviewStreamHint?.(sessionKey, { skipTaskReview: ranSlashCommand });
 	} finally {
-		if (channel === "webchat") deps.unregisterWebchatSsePublisher(sessionKey);
+		if (channel === "webchat") deps.unregisterWebchatStreamPublisher(sessionKey);
 		deps.endDirectRequestContext();
 	}
 }

package/dist/src/agent/service.d.ts

@@ -50,7 +50,7 @@ export declare class AgentService {
     private inboundLoop;
     /**
      * Direct-turn entry points: `processDirect` (one-shot), `processDirectStreaming`
-     * (SSE generator), webchat steering and SSE injection. Public so the gateway,
+     * (event generator), webchat steering and live event injection. Public so the gateway,
      * TUI, CLI, and automations do not need to thread every call through `AgentService`.
      */
     readonly turnDispatcher: TurnDispatcher;

package/dist/src/agent/service.js

@@ -118,7 +118,7 @@ var AgentService = class {
 	inboundLoop;
 	/**
 	* Direct-turn entry points: `processDirect` (one-shot), `processDirectStreaming`
-	* (SSE generator), webchat steering and SSE injection. Public so the gateway,
+	* (event generator), webchat steering and live event injection. Public so the gateway,
 	* TUI, CLI, and automations do not need to thread every call through `AgentService`.
 	*/
 	turnDispatcher;
@@ -218,6 +218,7 @@ var AgentService = class {
 			model: config.model,
 			config: config.config,
 			extensionRegistry: config.extensionRegistry,
+			endpointTools: config.endpointTools,
 			hookRunner: this.hookRunner,
 			bus,
 			getCurrentContext: () => this.sessionContextManager.getContext(),
@@ -373,7 +374,7 @@ var AgentService = class {
 				return c;
 			},
 			resolveSessionEndpoint: (sk) => this.resolveSessionEndpoint(sk),
-			initSessionContext: (sk, channel, chatId) => this.initSessionContext(sk, channel, chatId),
+			initSessionContext: (sk, channel, chatId, origin) => this.initSessionContext(sk, channel, chatId, origin),
 			sessionHydrator: this.sessionHydrator,
 			prepareInboundAttachments: (sk, att) => this.prepareInboundAttachments(sk, att),
 			enqueueMaybeAutoTitleAfterPersist: (sk) => this.enqueueMaybeAutoTitleAfterPersist(sk),
@@ -679,13 +680,14 @@ var AgentService = class {
 			chatId: metadata?.routing?.peerId?.trim() || metadata?.sourceChatId?.trim() || "main"
 		};
 	}
-	initSessionContext(sessionKey, channel, chatId, senderId = "") {
+	initSessionContext(sessionKey, channel, chatId, origin, senderId = "") {
 		const context = {
 			sessionKey,
 			channel,
 			chatId,
 			senderId,
-			isGroup: false
+			isGroup: false,
+			origin
 		};
 		this.contextMiddleware.onRequest({
 			sessionKey,

package/dist/src/agent/service.types.d.ts

@@ -8,11 +8,13 @@ import type { ProjectService } from '../projects/index.js';
 import type { LocalAppService } from '../local-apps/index.js';
 import type { GatewayClarifyRequestFn } from './tools/clarify-tool.js';
 import type { AgentSourceContextResolver } from './source-context/types.js';
+import type { EndpointToolRuntime } from '../endpoint-tools/index.js';
 export interface AgentServiceConfig {
     workspace: string;
     model?: string;
     config?: Config;
     extensionRegistry?: ExtensionRegistry;
+    endpointTools?: EndpointToolRuntime;
     maxRequestsPerTurn?: number;
     maxToolFailuresPerTurn?: number;
     maxTaskDurationMs?: number;

package/dist/src/agent/session/index.d.ts

@@ -3,7 +3,7 @@
  */
 export { SessionContextManager, type SessionContext, } from './session-context.js';
 export { SessionLifecycleManager, type SessionLifecycleEvents, type SessionStats, } from './session-lifecycle.js';
-export { SessionStateBag, type SessionStateBagOptions, type WebchatSsePublisher, type TaskReviewStreamHint, } from './session-state-bag.js';
+export { SessionStateBag, type SessionStateBagOptions, type WebchatStreamPublisher, type TaskReviewStreamHint, } from './session-state-bag.js';
 export { SessionConfigService, type SessionConfigServiceOptions, type PatchSessionAgentConfigInput, type PatchSessionAgentConfigResult, } from './session-config-service.js';
 export { SessionHydrator, type SessionHydratorOptions, } from './session-hydrator.js';
 export { SessionInspector, type SessionInspectorOptions, type SessionContextUsage, type SessionAgentConfigView, } from './session-inspector.js';

package/dist/src/agent/session/session-context.d.ts

@@ -14,6 +14,7 @@
  * awkward; the context leaks into the rest of the current async resource by
  * design).
  */
+import type { TurnOrigin } from '@xopcai/endpoint-tools-protocol';
 import type { InboundMessage } from '../../infra/bus/index.js';
 export interface SessionContext {
     sessionKey: string;
@@ -21,6 +22,7 @@ export interface SessionContext {
     chatId: string;
     senderId: string;
     isGroup: boolean;
+    origin: TurnOrigin;
     model?: string;
     metadata?: Record<string, unknown>;
 }

package/dist/src/agent/session/session-context.js

@@ -52,6 +52,10 @@ var SessionContextManager = class {
 			chatId: msg.chat_id,
 			senderId: metadata.senderId || "",
 			isGroup: metadata.isGroup || false,
+			origin: {
+				type: "channel",
+				channel: msg.channel
+			},
 			model: metadata.model,
 			metadata
 		};