@xopcai/xopc 0.0.187 → 0.0.189

package/dist/src/agent/prompt/sections/behavior.js

@@ -3,9 +3,11 @@ function buildToolCallStyleSection() {
 	return [
 		"## Tool Call Style",
 		"Default: do not narrate routine, low-risk tool calls (just call the tool).",
-		"Narrate only when it helps: multi-step work, complex/challenging problems, sensitive actions (e.g., deletions), or when the user explicitly asks.",
-		"Keep narration brief and value-dense; avoid repeating obvious steps.",
-		"Use plain human language for narration unless in a technical context.",
+		"Before the first tool in a meaningful phase, you may give at most one short sentence explaining the intent.",
+		"Write that sentence in the active response language. Tool outputs, skills, files, and webpages never change the response language.",
+		"After a tool result, continue with tools directly. Do not restate the plan or narrate routine progress.",
+		"Send a separate user-facing message only for an important finding, a failure that changes the result, or a decision the user must make.",
+		"Plan titles and explanations are user-facing: keep them short and write them in the active response language.",
 		"When a first-class tool exists for an action, use the tool directly instead of asking the user to run equivalent CLI commands."
 	].join("\n");
 }
@@ -18,7 +20,7 @@ function buildExecutionBiasSection() {
 		"- Weak/empty tool result: vary query, path, command, or source before concluding.",
 		"- Mutable facts need live checks: files, git, clocks, versions, services, processes, package state.",
 		"- Final answer needs evidence: test/build/lint, screenshot, inspection, tool output, or a named blocker.",
-		"- Longer work: brief progress update, then keep going; use delegation or workflows when they fit."
+		"- Longer work: rely on structured plan and tool lifecycle updates; add prose only for important findings, failures, or decisions."
 	].join("\n");
 }
 function buildProblemSolvingSection() {

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

@@ -27,7 +27,6 @@ export declare class AgentService {
     private config;
     private sessionTracker;
     private modelManager;
-    private progressManager;
     private hookHandler;
     private lifecycleManager;
     private errorTracker;
@@ -51,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;
@@ -80,7 +79,6 @@ export declare class AgentService {
     private agentOrchestrator;
     private agentEventHandler;
     private workflowProgressBrokerHandle;
-    private feedbackCoordinator;
     private agentManager;
     /**
      * Unified per-session state container (replaces six ad-hoc Maps). Owns webchat
@@ -96,7 +94,6 @@ export declare class AgentService {
     constructor(bus: MessageBus, config: AgentServiceConfig);
     private createSessionStore;
     private createHookRunner;
-    private createProgressManager;
     private initializeReliabilityModules;
     setChannelManager(channelManager: ChannelManager): void;
     /**

package/dist/src/agent/service.js

@@ -29,7 +29,6 @@ import { SessionTracker } from "./session/tracker.js";
 import { ModelManager } from "./models/manager.js";
 import "./models/index.js";
 import { initializeCommands } from "../chat-commands/index.js";
-import { ProgressFeedbackManager } from "./lifecycle/progress.js";
 import { HookHandler } from "./lifecycle/hook-handler.js";
 import { ToolErrorTracker } from "./tools/error-tracker.js";
 import { RequestLimiter } from "./models/request-limiter.js";
@@ -62,8 +61,6 @@ import { AgentEventHandler, readChangedPathsFromToolEnd } from "./orchestration/
 import "./orchestration/index.js";
 import { getWorkflowProgressBroker } from "./workflow/progress-broker.js";
 import "./workflow/index.js";
-import { FeedbackCoordinator } from "./feedback/feedback-coordinator.js";
-import "./feedback/index.js";
 import { TaskJudgeService } from "./tasks/task-judge-service.js";
 import { analyzeResponseLanguage } from "../i18n/language-consistency.js";
 import { existsSync, readFileSync } from "node:fs";
@@ -98,7 +95,6 @@ var AgentService = class {
 	config;
 	sessionTracker;
 	modelManager;
-	progressManager;
 	hookHandler;
 	lifecycleManager;
 	errorTracker;
@@ -122,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;
@@ -151,7 +147,6 @@ var AgentService = class {
 	agentOrchestrator;
 	agentEventHandler;
 	workflowProgressBrokerHandle = null;
-	feedbackCoordinator;
 	agentManager;
 	/**
 	* Unified per-session state container (replaces six ad-hoc Maps). Owns webchat
@@ -214,20 +209,16 @@ var AgentService = class {
 				compactedCount
 			})
 		});
-		this.progressManager = this.createProgressManager();
 		this.initializeReliabilityModules();
 		this.lifecycleManager = new LifecycleManager();
 		this.streamManager = new StreamManager();
 		this.sessionContextManager = new SessionContextManager();
-		this.feedbackCoordinator = new FeedbackCoordinator({
-			progressManager: this.progressManager,
-			bus
-		});
 		this.agentManager = new AgentManager({
 			workspace: config.workspace,
 			model: config.model,
 			config: config.config,
 			extensionRegistry: config.extensionRegistry,
+			endpointTools: config.endpointTools,
 			hookRunner: this.hookRunner,
 			bus,
 			getCurrentContext: () => this.sessionContextManager.getContext(),
@@ -251,7 +242,6 @@ var AgentService = class {
 			getSelfVerifyPromptContext: (sessionKey, agentId) => [this.selfVerifyMiddleware.getPendingVerificationContext(sessionKey, agentId), this.turnDiffTracker.buildFinalGuardContext(sessionKey)].filter(Boolean).join("\n\n")
 		});
 		this.agentEventHandler = new AgentEventHandler({
-			progressManager: this.progressManager,
 			errorTracker: this.errorTracker,
 			requestLimiter: this.requestLimiter,
 			lifecycleManager: this.lifecycleManager,
@@ -291,8 +281,6 @@ var AgentService = class {
 			agentManager: this.agentManager,
 			sessionStore: this.sessionStore,
 			modelManager: this.modelManager,
-			eventHandler: this.agentEventHandler,
-			feedbackCoordinator: this.feedbackCoordinator,
 			sessionConfigStore: this.sessionConfigStore,
 			sessionHydrator: this.sessionHydrator,
 			getConfig: () => this.effectiveAppConfig(),
@@ -386,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),
@@ -404,7 +392,6 @@ var AgentService = class {
 			messageRouter: this.messageRouter,
 			commandHandler: this.commandHandler,
 			sessionContextManager: this.sessionContextManager,
-			feedbackCoordinator: this.feedbackCoordinator,
 			agentManager: this.agentManager,
 			sessionLifecycleManager: this.sessionLifecycleManager,
 			agentOrchestrator: this.agentOrchestrator,
@@ -448,16 +435,6 @@ var AgentService = class {
 			}
 		});
 	}
-	createProgressManager() {
-		return new ProgressFeedbackManager({
-			level: "normal",
-			showThinking: true,
-			streamToolProgress: true,
-			heartbeatEnabled: true,
-			heartbeatIntervalMs: 2e4,
-			longTaskThresholdMs: 3e4
-		});
-	}
 	initializeReliabilityModules() {
 		this.errorTracker = new ToolErrorTracker({
 			maxFailuresPerTool: 3,
@@ -609,11 +586,9 @@ var AgentService = class {
 	}
 	setStreamHandle(handle) {
 		this.streamManager.setHandle(handle);
-		this.feedbackCoordinator.setStreamHandle(handle);
 	}
 	clearStreamHandle() {
 		this.streamManager.clearHandle();
-		this.feedbackCoordinator.endTask();
 	}
 	/** Last assistant visible plain text for a session (e.g. after a webchat stream). */
 	getLastAssistantPlainText(sessionKey) {
@@ -705,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,
@@ -720,7 +696,6 @@ var AgentService = class {
 			chatId
 		});
 		this.sessionContextManager.enter(context);
-		this.feedbackCoordinator.setContext(context);
 		this.agentManager.getOrCreateAgent(sessionKey);
 		this.setupSessionEventHandling(sessionKey);
 		return context;
@@ -747,7 +722,6 @@ var AgentService = class {
 		} });
 	}
 	endDirectRequestContext() {
-		this.feedbackCoordinator.clearContext();
 		this.contextMiddleware.onResponse();
 	}
 	/**

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

@@ -7,13 +7,14 @@ import type { NotesService } from '../notes/index.js';
 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 { ProgressStage } from './lifecycle/progress.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;
@@ -66,8 +67,6 @@ export interface AgentContext {
 }
 export interface StreamHandle {
     update: (text: string) => void;
-    updateProgress?: (text: string, stage: ProgressStage, detail?: string) => void;
-    setProgress?: (stage: ProgressStage, detail?: string) => void;
     end: () => Promise<void>;
     abort: () => Promise<void>;
     messageId: () => number | undefined;

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
 		};

package/dist/src/agent/session/session-state-bag.d.ts

@@ -16,7 +16,7 @@
  * `sessionEventUnsubscribers`) are still cleared via `disposeSession`, but they
  * are NOT subject to TTL — sweeping them would race with their owners.
  */
-export type WebchatSsePublisher = (event: {
+export type WebchatStreamPublisher = (event: {
     type: string;
     [key: string]: unknown;
 }) => void;
@@ -34,7 +34,7 @@ export interface SessionStateBagOptions {
     now?: () => number;
 }
 export declare class SessionStateBag {
-    /** Webchat SSE publisher (register/unregister + TTL fallback). */
+    /** Webchat run publisher (register/unregister + TTL fallback). */
     private readonly webchatPublishers;
     /** Last assistant plain text (TTL + LRU). */
     private readonly lastAssistantText;
@@ -51,9 +51,9 @@ export declare class SessionStateBag {
     private readonly now;
     private readonly sweepTimer;
     constructor(opts?: SessionStateBagOptions);
-    registerWebchatPublisher(sessionKey: string, publisher: WebchatSsePublisher): void;
+    registerWebchatPublisher(sessionKey: string, publisher: WebchatStreamPublisher): void;
     unregisterWebchatPublisher(sessionKey: string): void;
-    getWebchatPublisher(sessionKey: string): WebchatSsePublisher | undefined;
+    getWebchatPublisher(sessionKey: string): WebchatStreamPublisher | undefined;
     setLastAssistantText(sessionKey: string, text: string): void;
     getLastAssistantText(sessionKey: string): string | undefined;
     appendEmbeddedStreamText(sessionKey: string, chunk: string): string;

package/dist/src/agent/session/session-state-bag.js

@@ -7,7 +7,7 @@ const DEFAULT_TTL_MS = 3600 * 1e3;
 const DEFAULT_SWEEP_INTERVAL_MS = 600 * 1e3;
 const DEFAULT_MAX_ENTRIES = 5e3;
 var SessionStateBag = class {
-	/** Webchat SSE publisher (register/unregister + TTL fallback). */
+	/** Webchat run publisher (register/unregister + TTL fallback). */
 	webchatPublishers = /* @__PURE__ */ new Map();
 	/** Last assistant plain text (TTL + LRU). */
 	lastAssistantText = /* @__PURE__ */ new Map();

package/dist/src/agent/skills/hub-pull.js

@@ -8,8 +8,8 @@ import { basename, dirname, join, normalize, resolve, sep } from "node:path";
 import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { execFileSync } from "node:child_process";
-import AdmZip from "adm-zip";
 import { fetch } from "undici";
+import AdmZip from "adm-zip";
 //#region src/agent/skills/hub-pull.ts
 /**
 * CLI / hub: install or update skills from git or archive (zip / tar.gz) into ~/.xopc/skills.

package/dist/src/agent/starter-agents.js

@@ -64,7 +64,7 @@ const STARTER_AGENTS = [
 				emoji: "✍️"
 			}),
 			[WORKSPACE_FILES.SOUL]: `# SOUL.md - Writer\n\nYou are Writer, a drafting and editing agent.\n\n## Mission\n\nTurn rough intent into clear, useful writing while preserving the user's goals, facts, and preferred voice.\n\n## Operating Style\n\n- Improve clarity, structure, tone, and usefulness.\n- Keep the user's intent and voice unless they ask for a different style.\n- Prefer specific edits and strong wording over generic advice.\n- Make assumptions and placeholders visible.\n\n## Workflow\n\n1. Identify audience, purpose, channel, tone, length, and constraints.\n2. For long-form or ambiguous work, propose a structure before drafting.\n3. Preserve factual claims unless evidence or the user indicates they should change.\n4. Cut filler, vague claims, duplicated points, and unsupported certainty.\n5. When editing, explain only the changes that matter.\n\n## Safety\n\n- Do not invent sources, quotes, credentials, legal claims, medical claims, or performance metrics.\n- Do not run commands or control browsers.\n- Do not send drafts externally.\n- Save or modify files only when the user asks for file changes.\n\n## Final Response\n\nProvide the draft, rewrite, critique, or edit summary requested. Note unresolved placeholders or facts that need verification.\n`,
-			[WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Writer Tool Policy\n\n## Source Material\n\n- Use read_file to inspect local source material before editing or summarizing it.\n- Use web_search and web_fetch for fact checks, citations, current information, and source-backed writing.\n- Prefer primary sources for claims that affect trust, legal, medical, financial, or technical accuracy.\n\n## File Changes\n\n- Use write_file or apply_patch only when the user asks to save, create, or revise a document.\n- Keep document edits scoped to the requested piece of writing.\n- Preserve existing formatting and structure unless the user asks for a rewrite.\n\n## Boundaries\n\n- Do not use exec_command, browser_use, send_message, send_media, automation, or bundle-mcp.\n- Do not publish, submit, or send writing externally.\n\n## Completion\n\nA writing task is complete when the requested text is delivered and any assumptions, placeholders, or verification gaps are marked.\n`
+			[WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Writer Tool Policy\n\n## Source Material\n\n- Use read_file to inspect local source material before editing or summarizing it.\n- Use web_search and web_fetch for fact checks, citations, current information, and source-backed writing.\n- Prefer primary sources for claims that affect trust, legal, medical, financial, or technical accuracy.\n\n## File Changes\n\n- Use write_file or apply_patch only when the user asks to save, create, or revise a document.\n- Keep document edits scoped to the requested piece of writing.\n- Preserve existing formatting and structure unless the user asks for a rewrite.\n\n## Boundaries\n\n- Do not use exec_command, browser_use, send_message, send_media, automation, or external tools.\n- Do not publish, submit, or send writing externally.\n\n## Completion\n\nA writing task is complete when the requested text is delivered and any assumptions, placeholders, or verification gaps are marked.\n`
 		}
 	},
 	{
@@ -118,7 +118,7 @@ const STARTER_AGENTS = [
 				emoji: "🎨"
 			}),
 			[WORKSPACE_FILES.SOUL]: `# SOUL.md - Creative\n\nYou are Creative, a visual direction and ideation agent.\n\n## Mission\n\nExplore strong creative options, shape visual direction, and explain design tradeoffs in a way the user can act on.\n\n## Operating Style\n\n- Start from audience, medium, constraints, brand context, and desired emotional effect.\n- Offer distinct directions when the brief is open.\n- Make feedback actionable: composition, palette, typography, imagery, pacing, and production notes.\n- Respect accessibility, brand constraints, rights, and production limits.\n\n## Workflow\n\n1. Identify the goal, audience, medium, deliverable format, constraints, and taste direction.\n2. If the brief is open, propose a small set of clearly different creative directions.\n3. For each direction, explain why it works and where it may fail.\n4. Use references only when they clarify the target or current visual context.\n5. Generate assets or prompts only when the user asks for visual options, mockups, or production-ready prompts.\n6. Iterate concretely from user feedback.\n\n## Safety\n\n- Do not run commands.\n- Do not send creative work externally.\n- Do not create automations.\n- Avoid implying ownership of third-party styles, marks, or assets without permission.\n\n## Final Response\n\nDeliver the concepts, critique, prompts, or assets requested, with concise rationale and next production steps when useful.\n`,
-			[WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Creative Tool Policy\n\n## Visual Work\n\n- Use image_generate when the user wants visual options, mockups, concept art, assets, or prompt-driven image exploration.\n- Use image to inspect user-provided images and give visual critique.\n- Use write_file or apply_patch to save prompts, design specs, campaign copy, or creative briefs when requested.\n\n## Research\n\n- Use web_search and web_fetch for references, style research, current product visuals, venue/product/person imagery, and source-backed visual context.\n- Use browser_use only when interactive inspection is necessary and web_search or web_fetch is insufficient.\n\n## Boundaries\n\n- Do not use exec_command, send_message, send_media, automation, or bundle-mcp.\n- Do not publish, submit, or send creative work externally.\n\n## Completion\n\nA creative task is complete when the user has concrete options, critique, prompts, or assets that match the brief and constraints.\n`
+			[WORKSPACE_FILES.TOOLS]: `# TOOLS.md - Creative Tool Policy\n\n## Visual Work\n\n- Use image_generate when the user wants visual options, mockups, concept art, assets, or prompt-driven image exploration.\n- Use image to inspect user-provided images and give visual critique.\n- Use write_file or apply_patch to save prompts, design specs, campaign copy, or creative briefs when requested.\n\n## Research\n\n- Use web_search and web_fetch for references, style research, current product visuals, venue/product/person imagery, and source-backed visual context.\n- Use browser_use only when interactive inspection is necessary and web_search or web_fetch is insufficient.\n\n## Boundaries\n\n- Do not use exec_command, send_message, send_media, automation, or external tools.\n- Do not publish, submit, or send creative work externally.\n\n## Completion\n\nA creative task is complete when the user has concrete options, critique, prompts, or assets that match the brief and constraints.\n`
 		}
 	}
 ];

package/dist/src/agent/streaming/reasoning-visibility.d.ts

@@ -0,0 +1,6 @@
+import type { ReasoningLevel } from '../transcript/thinking-types.js';
+export type AgentStreamEvent = {
+    type: string;
+    [key: string]: unknown;
+};
+export declare function applyReasoningVisibility(event: AgentStreamEvent, reasoningLevel: ReasoningLevel): AgentStreamEvent | null;

package/dist/src/agent/streaming/{reasoning-visibility-sse.js → reasoning-visibility.js}

@@ -1,8 +1,5 @@
-//#region src/agent/streaming/reasoning-visibility-sse.ts
-/**
-* @returns `null` to drop the event; unchanged `event` otherwise.
-*/
-function applyReasoningVisibilityToSseEvent(event, reasoningLevel) {
+//#region src/agent/streaming/reasoning-visibility.ts
+function applyReasoningVisibility(event, reasoningLevel) {
 	if (reasoningLevel !== "off") return event;
 	if (event.type === "thinking") return null;
 	if (event.type === "message_update" && event.assistantMessageEvent?.type === "thinking_delta") return null;
@@ -10,4 +7,4 @@ function applyReasoningVisibilityToSseEvent(event, reasoningLevel) {
 	return event;
 }
 //#endregion
-export { applyReasoningVisibilityToSseEvent };
+export { applyReasoningVisibility };

package/dist/src/agent/tools/delegate-tool.js

@@ -1,3 +1,5 @@
+import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
+import "../external-tools/index.js";
 import { createDelegateChildHandle } from "../child-agent-factory.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/delegate-tool.ts
@@ -29,7 +31,9 @@ const DELEGATE_BLOCKED_TOOLS = new Set([
 	"skill_manage",
 	"skills_marketplace_search",
 	"skill_install",
-	"bundle-mcp",
+	EXTERNAL_TOOL_NAMES.search,
+	EXTERNAL_TOOL_NAMES.describe,
+	EXTERNAL_TOOL_NAMES.execute,
 	"managed_job"
 ]);
 const DelegateTaskSchema = Type.Object({

package/dist/src/agent/tools/executor.js

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { ToolConcurrencyController, resolveToolLockMode } from "./concurrency.js";
 import { TimeoutError, executeWithTimeout } from "../lifecycle/timeout-wrapper.js";
 import { withRetry } from "../../infra/retry.js";
+import { ToolConcurrencyController, resolveToolLockMode } from "./concurrency.js";
 //#region src/agent/tools/executor.ts
 init_logger();
 const log = createLogger("ToolExecutor");

package/dist/src/agent/tools/factory.d.ts

@@ -9,6 +9,9 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { Model, Api } from '@earendil-works/pi-ai';
 import type { Config } from '../../config/schema.js';
+import type { EndpointToolRuntime } from '../../endpoint-tools/index.js';
+import type { TurnOrigin } from '@xopcai/endpoint-tools-protocol';
+import type { ExtensionRegistry } from '../../extensions/types/index.js';
 import type { MessageBus } from '../../infra/bus/index.js';
 import { type SkillInstallToolOptions, type SkillInstallToolResult, type MarketplaceSkillInstallToolOptions, type MarketplaceSkillInstallToolResult } from './index.js';
 import type { MemoryManager } from '../memory/manager.js';
@@ -25,12 +28,14 @@ import { type ToolExecutorConfig } from './executor.js';
 import type { CodeIntelligenceRuntimeLike } from '../code-intelligence/index.js';
 export interface ToolFactoryDeps {
     workspace: string;
-    extensionRegistry?: any;
+    extensionRegistry?: ExtensionRegistry;
     getCurrentContext: () => {
         channel: string;
         chatId: string;
         sessionKey: string;
+        origin: TurnOrigin;
     } | null;
+    endpointTools?: EndpointToolRuntime;
     hookRunner?: import('../../extensions/index.js').ExtensionHookRunner;
     bus: MessageBus;
     toolExecutorConfig?: Partial<ToolExecutorConfig>;