@xopcai/xopc 0.0.426 → 0.0.427

package/dist/src/agent/tools/create-share-tool.js

@@ -1,5 +1,6 @@
 import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { resolveReverseProxyPublicUrl } from "../../gateway/public-url.js";
 import { assertWorkspaceTreeReadable, checkedFilePath } from "../sandbox/fileAccess.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
@@ -9,7 +10,6 @@ import { getShareStore } from "../../share/share-store.js";
 import { getSiteShareStore } from "../../share/site-share-store.js";
 import { resolveShareUrl, resolveSiteShareUrl } from "../../share/share-url.js";
 import { publishHostedStaticSite } from "../../share/hosted-static-site-publish.js";
-import { resolveReverseProxyPublicUrl } from "../../gateway/public-url.js";
 import { audienceDefaults, decideShareKind, makeDescription, makeTitle, probeShareTarget, rememberStagedSite, stageSingleHtmlAsSite } from "../../share/share-auto.js";
 import { scheduleThumbnail } from "../../share/share-thumbnail.js";
 import { resolveToolLocale, shareToolErrorLine, shareToolSuccessLines } from "../../i18n/share-tool-bundle.js";

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

@@ -34,6 +34,8 @@ export interface ToolFactoryDeps {
         chatId: string;
         conversationId: string;
         origin: TurnOrigin;
+        isGroup?: boolean;
+        metadata?: Record<string, unknown>;
     } | null;
     endpointTools?: EndpointToolRuntime;
     hookRunner?: import('../../extensions/index.js').ExtensionHookRunner;
@@ -60,6 +62,7 @@ export interface ToolFactoryDeps {
     canConfigureEndpoint?: (endpointId: string) => boolean;
     getPhoneSetupService?: () => import('../../phone/setup/service.js').PhoneSetupService | undefined;
     getBrowserSetupService?: () => import('../../browser/setup/service.js').BrowserSetupService | undefined;
+    getMcpSetupService?: () => import('../mcp/conversation-setup.js').McpConversationSetup | undefined;
     getBrowserAutomationService?: () => BrowserAutomationService | undefined;
     emitBrowserEvent?: (type: string, payload: unknown) => void;
     /** Gateway: enables the `xopc_use` product-object tool. */

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

@@ -9,6 +9,8 @@ import { patchSessionMetadata } from "../../storage/sqlite/session-repository.js
 import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/session-task-plan-repository.js";
 import "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
+import { getConversationRouting } from "../../storage/sqlite/conversation-repository.js";
+import { init_session_key } from "../../routing/session-key.js";
 import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
 import { PERSONAL_TOOL_DESCRIPTIONS } from "../../personal-agent/policy.js";
@@ -24,10 +26,12 @@ import { markCodemodeCoreRead } from "./codemode-permissions.js";
 import "../../../packages/browser-control-contract/src/index.js";
 import { wrapToolsWithProtection } from "./executor.js";
 import { createDefaultExternalToolGatewayTools } from "../external-tools/index.js";
-import { createReadFileTool } from "./read.js";
-import { createDataBatchTool } from "./dataBatch.js";
 import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
 import { skillEnvironmentId } from "../skills/installer.js";
+import { createDataBatchTool } from "./dataBatch.js";
+import { createXopcUseTool } from "./xopc-use-tool.js";
+import { createMcpSetupTool } from "./mcp-setup-tool.js";
+import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
 import { createListDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
@@ -59,7 +63,6 @@ import { getActiveTranscriptUserText, getPendingTranscriptUserText } from "../in
 import { createDelegateTool } from "./delegate-tool.js";
 import { createAutomationTool } from "./automation-tool.js";
 import { createBrowserAutomationTool } from "./browser-automation-tool.js";
-import { createXopcUseTool } from "./xopc-use-tool.js";
 import { createSkillViewTool, createSkillsListTool } from "./skills-tools.js";
 import { createSkillManageTool } from "./skill-manage-tool.js";
 import { createSkillsMarketplaceSearchTool } from "./skills-marketplace-search-tool.js";
@@ -93,6 +96,7 @@ import { sortToolsForPromptCache } from "./cache-stability.js";
 init_agent_scope();
 init_request_repository();
 init_logger();
+init_session_key();
 init_paths_state();
 const log = createLogger("AgentToolsFactory");
 /** Channels where `clarify` can block for a user answer (web UI, Telegram, CLI readline). */
@@ -324,6 +328,12 @@ var AgentToolsFactory = class AgentToolsFactory {
 		const grep = createGrepTool(workspace);
 		const find = createFindTool(workspace);
 		const productToolDeps = {
+			canRequestWeixinMcpSetup: () => {
+				const context = this.deps.getCurrentContext();
+				if (!context || context.origin.type !== "channel" || context.origin.channel !== "weixin" || context.isGroup) return false;
+				const route = getConversationRouting(context.conversationId);
+				return route?.accountId === context.metadata?.accountId && route.peerId.toLowerCase() === context.chatId.toLowerCase();
+			},
 			canConfigureFromConversation: () => {
 				const origin = this.deps.getCurrentContext()?.origin;
 				return origin?.type === "system" && origin.source === "cli" || origin?.type === "endpoint" && this.deps.canConfigureEndpoint?.(origin.endpointId) === true;
@@ -341,6 +351,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 			getLocalAppService: this.deps.getLocalAppService,
 			getChatPreviewService: this.deps.getChatPreviewService,
 			getBrowserSetupService: this.deps.getBrowserSetupService,
+			getMcpSetupService: this.deps.getMcpSetupService,
 			getPhoneSetupService: this.deps.getPhoneSetupService,
 			dispatchTaskEvents: this.deps.dispatchTaskEvents,
 			dispatchTaskRuns: this.deps.dispatchTaskRuns,
@@ -398,7 +409,8 @@ var AgentToolsFactory = class AgentToolsFactory {
 				createSkillManageTool({
 					getSkillManager: getSkillMgr,
 					getWorkspace: () => workspace,
-					onSkillsFilesystemMutate: this.deps.onSkillsFilesystemMutate
+					onSkillsFilesystemMutate: this.deps.onSkillsFilesystemMutate,
+					getSkillIndexingContext: this.deps.getSkillIndexingContext
 				})
 			] : [],
 			createSkillsMarketplaceSearchTool({
@@ -559,26 +571,25 @@ var AgentToolsFactory = class AgentToolsFactory {
 				getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId,
 				canAccess: () => currentAccess().crossSessionHistory
 			})] : [],
-			...this.deps.getAutomationService ? [createAutomationTool({
-				getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId,
-				getAutomationService: this.deps.getAutomationService,
-				getCurrentAgentId: () => options.agentId,
-				getProjectService: this.deps.getProjectService
-			})] : [],
+			...this.deps.getAutomationService ? [createAutomationTool(productToolDeps)] : [],
 			...browserEnabled && this.deps.getBrowserAutomationService ? [createBrowserAutomationTool({ getBrowserAutomationService: this.deps.getBrowserAutomationService })] : [],
-			...this.deps.getPhoneSetupService || this.deps.getBrowserSetupService || this.deps.getAutomationService || this.deps.getProjectService || this.deps.getNotesService || this.deps.getLocalAppService || this.deps.getChatPreviewService || this.deps.dispatchTaskEvents || this.deps.dispatchTaskRuns ? [createXopcUseTool(productToolDeps), ...personalToolsConfigured ? [
-				createPersonalTaskTool(productToolDeps),
-				createPersonalReadTool({
-					...productToolDeps,
-					getCurrentConversationId: currentConversationId
-				}),
-				createPersonalResultTool(currentConversationId),
-				...createPersonalRequestTools(productToolDeps),
-				createPersonalAttentionTool({
-					getConversationId: () => this.deps.getCurrentContext()?.conversationId,
-					getConfig: () => this.deps.getConfig?.()
-				})
-			] : []] : [],
+			...this.deps.getPhoneSetupService || this.deps.getBrowserSetupService || this.deps.getAutomationService || this.deps.getProjectService || this.deps.getNotesService || this.deps.getLocalAppService || this.deps.getChatPreviewService || this.deps.dispatchTaskEvents || this.deps.dispatchTaskRuns ? [
+				createXopcUseTool(productToolDeps),
+				...this.deps.getMcpSetupService ? [createMcpSetupTool(productToolDeps)] : [],
+				...personalToolsConfigured ? [
+					createPersonalTaskTool(productToolDeps),
+					createPersonalReadTool({
+						...productToolDeps,
+						getCurrentConversationId: currentConversationId
+					}),
+					createPersonalResultTool(currentConversationId),
+					...createPersonalRequestTools(productToolDeps),
+					createPersonalAttentionTool({
+						getConversationId: () => this.deps.getCurrentContext()?.conversationId,
+						getConfig: () => this.deps.getConfig?.()
+					})
+				] : []
+			] : [],
 			...cfg?.phone?.enabled || this.deps.getPhoneSetupService ? [createPhoneUseTool({
 				runtime: getPhoneRuntime(),
 				getSetupService: this.deps.getPhoneSetupService,

package/dist/src/agent/tools/image-generate-tool.js

@@ -1,10 +1,10 @@
 import { getAgentDefaultImageGenerationModelConfig, init_schema } from "../../config/schema.js";
-import { readWorkspaceFile, writeWorkspaceFile } from "../sandbox/fileAccess.js";
-import { imageAssetFromDataUrl, imageFileExtensionForMimeType, mimeTypeFromFileName, parseImageDataUrl, sniffImageMimeType } from "../image/generation/image-assets.js";
-import { persistToolMedia } from "./tool-media.js";
 import { buildCapabilityPlansForConfig } from "../../capabilities/readiness/from-config.js";
 import "../../capabilities/readiness/index.js";
 import { applyImageGenerationModelConfigDefaults } from "../image/image-helpers.js";
+import { readWorkspaceFile, writeWorkspaceFile } from "../sandbox/fileAccess.js";
+import { imageAssetFromDataUrl, imageFileExtensionForMimeType, mimeTypeFromFileName, parseImageDataUrl, sniffImageMimeType } from "../image/generation/image-assets.js";
+import { persistToolMedia } from "./tool-media.js";
 import { isFailoverError } from "../failover-error.js";
 import { getImageGenerationProvider } from "../image/generation/provider-registry.js";
 import { generateImage, listImageGenerationProvidersSummary } from "../image/generation/runtime.js";

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

@@ -1,3 +1,4 @@
+export { createMcpSetupTool } from './mcp-setup-tool.js';
 export { getToolMetadata, DEFAULT_TOOL_METADATA, type AgentToolWithMetadata, type ToolMutationScope, type ToolVerificationKind, type XopcToolMetadata, } from './metadata.js';
 export { ToolConcurrencyController, resolveToolLockMode, type ToolLockMode, } from './concurrency.js';
 export { createReadFileTool, type CreateReadFileToolOptions } from './read.js';

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

@@ -1,8 +1,11 @@
 import { DEFAULT_TOOL_METADATA, getToolMetadata } from "./metadata.js";
 import { ToolConcurrencyController, resolveToolLockMode } from "./concurrency.js";
+import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
+import { createDataBatchTool } from "./dataBatch.js";
+import { createXopcUseTool } from "./xopc-use-tool.js";
+import { createMcpSetupTool } from "./mcp-setup-tool.js";
 import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, GREP_MAX_LINE_LENGTH, formatSize, truncateHead, truncateLine, truncateTail } from "./truncate.js";
 import { createReadFileTool } from "./read.js";
-import { createDataBatchTool } from "./dataBatch.js";
 import { createWriteFileTool, writeFileTool } from "./write.js";
 import { createListDirTool, listDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
@@ -30,11 +33,9 @@ import { createClarifyTool } from "./clarify-tool.js";
 import { assertBrowserUrlAllowed } from "../../browser/url-policy.js";
 import { BrowserRuntime } from "../../browser/runtime/browser-runtime.js";
 import "../../browser/index.js";
-import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
 import { DEFAULT_DELEGATE_TOOLS, DELEGATE_BLOCKED_TOOLS, createDelegateTool } from "./delegate-tool.js";
 import { createAutomationTool } from "./automation-tool.js";
 import { createBrowserAutomationTool } from "./browser-automation-tool.js";
-import { createXopcUseTool } from "./xopc-use-tool.js";
 import { createSkillViewTool, createSkillsListTool } from "./skills-tools.js";
 import { createSkillManageTool } from "./skill-manage-tool.js";
 import { createSkillsMarketplaceSearchTool } from "./skills-marketplace-search-tool.js";
@@ -46,4 +47,4 @@ import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
 import { createPersonalReadTool } from "./personal-read-tool.js";
 import { createTaskCollaborationTool } from "./task-collaboration-tool.js";
-export { BrowserRuntime, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, createApplyPatchTool, createAutomationTool, createBrowserAutomationTool, createClarifyTool, createCreateShareTool, createDataBatchTool, createDelegateTool, createDesktopPetTool, createExecCommandTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createKnowledgeGetTool, createKnowledgeReadTool, createKnowledgeSearchTool, createKnowledgeWriteTool, createListDirTool, createManagedJobTool, createMemoryMaintenanceTool, createMessageTool, createPersonalReadTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTaskCollaborationTool, createTaskResultTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, createUserContextReadTool, createUserContextSearchTool, createUserContextUpdateTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserRuntime, DEFAULT_DELEGATE_TOOLS, DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, DEFAULT_TOOL_METADATA, DEFAULT_WEB_EXTRACT_MAX_LENGTH, DELEGATE_BLOCKED_TOOLS, GREP_MAX_LINE_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, createApplyPatchTool, createAutomationTool, createBrowserAutomationTool, createClarifyTool, createCreateShareTool, createDataBatchTool, createDelegateTool, createDesktopPetTool, createExecCommandTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createKnowledgeGetTool, createKnowledgeReadTool, createKnowledgeSearchTool, createKnowledgeWriteTool, createListDirTool, createManagedJobTool, createMcpSetupTool, createMemoryMaintenanceTool, createMessageTool, createPersonalReadTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTaskCollaborationTool, createTaskResultTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, createUserContextReadTool, createUserContextSearchTool, createUserContextUpdateTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };

package/dist/src/agent/tools/mcp-setup-tool.d.ts

@@ -0,0 +1,9 @@
+import type { AgentTool } from '@earendil-works/pi-agent-core';
+import { type XopcUseToolDeps } from './xopc-use-tool.js';
+declare const schema: import("@sinclair/typebox").TObject<{
+    command: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<string>[]>;
+    args: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TAny>>;
+}>;
+/** Small eager entry point; the existing product adapter owns authority and execution. */
+export declare function createMcpSetupTool(deps: XopcUseToolDeps): AgentTool<typeof schema, Record<string, unknown>>;
+export {};

package/dist/src/agent/tools/mcp-setup-tool.js

@@ -0,0 +1,32 @@
+import { createXopcUseTool } from "./xopc-use-tool.js";
+import { Type } from "@sinclair/typebox";
+//#region src/agent/tools/mcp-setup-tool.ts
+const schema = Type.Object({
+	command: Type.Union([
+		"inspect",
+		"start",
+		"get",
+		"advance",
+		"cancel",
+		"set_enabled",
+		"remove"
+	].map((value) => Type.Literal(value))),
+	args: Type.Optional(Type.Record(Type.String(), Type.Any(), { description: "inspect: {}. start: {serverId,url,purpose,displayName?,expectedRevision?}; derive an ASCII serverId if the user gave none. get: {setupId}. advance/cancel: {setupId,expectedVersion}. set_enabled/remove: {serverId,expectedRevision,enabled?}. Never include credentials." }))
+});
+/** Small eager entry point; the existing product adapter owns authority and execution. */
+function createMcpSetupTool(deps) {
+	const product = createXopcUseTool(deps);
+	return {
+		name: "mcp_setup",
+		label: "Connect MCP service",
+		parameters: schema,
+		description: "Configure a user-requested HTTP MCP service on the Gateway host, including user-provided localhost/127.0.0.1 addresses. Probe before claiming an address is unreachable. A clear request authorizes that specific local connection/change/removal; do not ask again. In a paired Weixin private chat, start proposes a specific owner-approved connection; global inspect is unavailable there. Otherwise inspect existing connections; start then advance with the returned version. Token/OAuth uses the trusted interactionPath, never chat input. The host resumes the original objective when ready. Read tool_manual xopc_use topic mcp for details. Connection success is not a business read.",
+		execute: (id, params, signal, update) => product.execute(id, {
+			mode: "mcp_setup",
+			command: params.command,
+			args: params.args
+		}, signal, update)
+	};
+}
+//#endregion
+export { createMcpSetupTool };

package/dist/src/agent/tools/personal-task-tool.js

@@ -12,10 +12,10 @@ import { TaskAllocationRepository } from "../../tasks/task-allocation-repository
 import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
 import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { boundedPersonalResult } from "./personal-result-budget.js";
-import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
-import "../../personal-agent/communication.js";
 import { parseTaskHandoffReferences } from "../../tasks/task-handoff.js";
+import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
+import "../../personal-agent/communication.js";
 import { getAvailablePersonalAgentTools, personalAgentModelAvailability } from "../../personal-agent/specialist-capabilities.js";
 import { assessSpecialist, matchSpecialists } from "../../agent-matching/service.js";
 import { createXopcUseTool } from "./xopc-use-tool.js";

package/dist/src/agent/tools/publish-artifacts.js

@@ -1,9 +1,9 @@
 import { turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
 import { readWorkspaceFile } from "../sandbox/fileAccess.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
-import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
 import { persistToolMedia } from "./tool-media.js";
 import { basename, isAbsolute, relative, sep } from "node:path";
 import { Type } from "@sinclair/typebox";

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

@@ -1,6 +1,6 @@
 import { checkedFilePath, readWorkspaceFileAsync } from "../sandbox/fileAccess.js";
-import { dataScheduler } from "../data-acquisition/scheduler.js";
 import { checkFileSafety } from "../prompt/safety.js";
+import { dataScheduler } from "../data-acquisition/scheduler.js";
 import { formatSize, truncateHead } from "./truncate.js";
 import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
 import { stat } from "fs/promises";

package/dist/src/agent/tools/skill-install-tool.js

@@ -1,7 +1,16 @@
+import { init_connection, isXopcDatabaseOpen } from "../../storage/sqlite/connection.js";
+import { DurableState } from "../../storage/sqlite/durable-state.js";
 import { isSkillInstallTarget } from "../skills/install-target.js";
+import { createHash } from "node:crypto";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/skill-install-tool.ts
+init_connection();
 const SkillInstallSchema = Type.Object({
+	idempotencyKey: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 200,
+		description: "Stable installation intent key. Keep the same key after a timeout; use a new key for a new install/update request."
+	})),
 	source: Type.Optional(Type.String({ description: "Explicit source install: Git URL, GitHub repository URL, https .zip/.tar.gz URL, file:// URL, or local archive/path." })),
 	provider: Type.Optional(Type.Union([
 		Type.Literal("store"),
@@ -21,7 +30,7 @@ function clean(value) {
 	return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
 function createSkillInstallTool(deps) {
-	return {
+	const tool = {
 		name: "skill_install",
 		label: "Install skill",
 		description: "Install an xopc skill from a Store/SkillHub/ClawHub marketplace result or an explicit source. Use only when the user clearly asks to install or update a skill; never treat search or a pasted URL as installation consent.",
@@ -146,6 +155,52 @@ function createSkillInstallTool(deps) {
 		idempotent: false,
 		finalGuardRelevant: true
 	};
+	const execute = tool.execute.bind(tool);
+	tool.execute = async (callId, params, signal, update) => {
+		if (!isXopcDatabaseOpen() || !deps.getConversationId?.()) return execute(callId, params, signal, update);
+		const key = clean(params.idempotencyKey) ?? callId;
+		const input = {
+			source: clean(params.source),
+			provider: clean(params.provider),
+			name: clean(params.name),
+			version: clean(params.version),
+			ref: clean(params.ref),
+			path: clean(params.path),
+			skillId: clean(params.skillId),
+			target: isSkillInstallTarget(params.target) ? params.target : "global",
+			force: params.force === true,
+			strictScan: params.strictScan === true
+		};
+		const fingerprint = createHash("sha256").update(JSON.stringify(input)).digest("hex");
+		const receipts = new DurableState("skills.install", deps.getConversationId());
+		const previous = receipts.update(key, (value) => ({
+			value: value ?? { fingerprint },
+			result: value
+		}));
+		if (previous) {
+			if (previous.fingerprint !== fingerprint) return {
+				content: [{
+					type: "text",
+					text: "Installation intent key was already used with different parameters."
+				}],
+				details: { errorCode: "intent_conflict" }
+			};
+			return previous.result ?? {
+				content: [{
+					type: "text",
+					text: "Installation result is not yet known. Inspect skill_manage status before taking further action; do not blindly reinstall or overwrite."
+				}],
+				details: { errorCode: "install_unknown" }
+			};
+		}
+		const result = await execute(callId, params, signal, update);
+		receipts.set(key, {
+			fingerprint,
+			result
+		});
+		return result;
+	};
+	return tool;
 }
 //#endregion
 export { createSkillInstallTool };

package/dist/src/agent/tools/skill-manage-tool.d.ts

@@ -4,5 +4,9 @@ export interface SkillManageToolDeps {
     getSkillManager: () => SkillManager | undefined;
     getWorkspace: () => string;
     onSkillsFilesystemMutate?: () => void;
+    getSkillIndexingContext?: () => {
+        registeredToolNames: string[];
+        skillAllowlist?: string[];
+    } | undefined;
 }
 export declare function createSkillManageTool(deps: SkillManageToolDeps): AgentTool;

package/dist/src/agent/tools/skill-manage-tool.js

@@ -1,6 +1,9 @@
 import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
-import { createSkillConfigManager } from "../skills/config.js";
+import { removeSkillsLockEntry } from "../skills/hub-lock.js";
+import { hasBinary } from "../skills/installer.js";
+import { createSkillConfigManager, getSkillEnvironment, isSkillEnabled, resolveSkillConfig } from "../skills/config.js";
+import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "../skills/workspace-skills-dir.js";
 import { applyPatchToContent, atomicWriteUtf8, effectiveAgentWritePolicy, ensureCategorySegment, isPathInsideDir, maxSkillMdChars, maxSupportFileBytes, mutatableSkillOrNull, resolveCreateSkillDir, scanSkillDirOrError, validateSkillMdContent, validateSkillNameSegment, validateSupportingRelativePath } from "../skills/skill-manage-ops.js";
 import { join } from "path";
 import { existsSync, rmSync } from "fs";
@@ -10,6 +13,9 @@ import { Type } from "@sinclair/typebox";
 init_paths();
 const SkillManageSchema = Type.Object({
 	action: Type.Union([
+		Type.Literal("status"),
+		Type.Literal("enable"),
+		Type.Literal("disable"),
 		Type.Literal("create"),
 		Type.Literal("edit"),
 		Type.Literal("patch"),
@@ -40,7 +46,7 @@ function createSkillManageTool(deps) {
 	return {
 		name: "skill_manage",
 		label: "🛠️ Skill",
-		description: "Create, edit, patch, or delete user skills under ~/.xopc/skills and/or workspace .xopc/skills/ (see skills.agentWritePolicy). Also write_file / remove_file under references/, templates/, scripts/, assets/. Bundled and extra-dir skills cannot be modified. Runs a security scan after writes.",
+		description: "Inspect installed skills with status (including disabled skills and current Agent availability); enable or disable by name. Create, edit, patch, or delete/uninstall user skills under ~/.xopc/skills and/or workspace .xopc/skills/ (see skills.agentWritePolicy). Also write_file / remove_file under references/, templates/, scripts/, assets/. Bundled and extra-dir skills cannot be modified. Runs a security scan after writes.",
 		parameters: SkillManageSchema,
 		async execute(_toolCallId, params) {
 			const mgr = deps.getSkillManager();
@@ -56,6 +62,71 @@ function createSkillManageTool(deps) {
 			const notify = () => deps.onSkillsFilesystemMutate?.();
 			try {
 				switch (params.action) {
+					case "status":
+					case "enable":
+					case "disable": {
+						const requested = params.name?.trim();
+						if (params.action !== "status" && !requested) return jsonResult({
+							success: false,
+							error: "name is required."
+						});
+						const skill = requested ? mgr.findSkill(requested) : void 0;
+						if (requested && !skill) return jsonResult({
+							success: false,
+							error: "Skill is not installed.",
+							errorCode: "skill_not_found"
+						});
+						if (params.action !== "status") {
+							const enabled = params.action === "enable";
+							const manager = createSkillConfigManager(resolveStateDir());
+							manager.setSkillEnabled(requested, enabled);
+							if (manager.load().entries?.[requested]?.enabled !== enabled) return jsonResult({
+								success: false,
+								error: "Skill enabled state could not be saved."
+							});
+							mgr.refreshPromptFromConfig();
+							notify();
+						}
+						const config = createSkillConfigManager(resolveStateDir()).load();
+						const indexing = deps.getSkillIndexingContext?.();
+						const canLoad = !indexing || indexing.registeredToolNames.includes("skill_view");
+						const visible = new Set(canLoad ? mgr.getEnabledSkillsForAgentSession(indexing).map((item) => item.name) : []);
+						return jsonResult({
+							success: true,
+							skills: (skill ? [skill] : mgr.getSkills()).map((item) => {
+								const enabled = resolveSkillConfig(item, config).enabled !== false;
+								const requires = item.metadata.xopc?.requires ?? item.metadata.requires;
+								const environment = getSkillEnvironment(item, config);
+								const missingEnv = requires?.env?.filter((name) => !environment[name]) ?? [];
+								const anyBinsMissing = Boolean(requires?.anyBins?.length && !requires.anyBins.some(hasBinary));
+								const requirementsMet = !missingEnv.length && !anyBinsMissing && isSkillEnabled(item, {
+									...config,
+									entries: {
+										...config.entries,
+										[item.name]: {
+											...config.entries?.[item.name],
+											enabled: true
+										}
+									}
+								});
+								return {
+									name: item.name,
+									description: item.description,
+									source: item.source,
+									managed: item.origin?.managed === true,
+									writable: Boolean(mutatableSkillOrNull(item, workspace, policy)),
+									enabled,
+									requirementsMet,
+									missingEnv,
+									availableToCurrentAgent: requirementsMet && visible.has(item.name),
+									state: !enabled ? "disabled" : !requirementsMet ? "requirements_unmet" : !visible.has(item.name) ? "agent_unavailable" : "ready",
+									verified: false
+								};
+							}),
+							managementPath: "/capabilities/skills?tab=installed",
+							guidance: "Ready means the current Agent can load the skill, not that a task has been tested. After installation, load skill_view and complete the requested task; explain relevant examples and any remaining requirements. Enabling is shared by skill name."
+						});
+					}
 					case "create": {
 						const nameErr = validateSkillNameSegment(params.name ?? "", "name");
 						if (nameErr) return jsonResult({
@@ -246,6 +317,7 @@ function createSkillManageTool(deps) {
 							recursive: true,
 							force: true
 						});
+						removeSkillsLockEntry(name, isPathInsideDir(resolveWorkspaceSkillsDir(workspace), sk.baseDir) ? resolveWorkspaceSkillsLockPath(workspace) : void 0);
 						notify();
 						return jsonResult({
 							success: true,

package/dist/src/agent/tools/skills-tools.js

@@ -1,7 +1,7 @@
 import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
-import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
 import { createSkillConfigManager, isSkillEnabled, resolveSkillConfig } from "../skills/config.js";
+import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
 import { resolveSkillReadablePath } from "../skills/skill-view-path.js";
 import { readFileSync, statSync } from "fs";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/task-collaboration-tool.js

@@ -8,9 +8,9 @@ import { init_session_repository } from "../../storage/sqlite/session-repository
 import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { getEmbeddedExecutionSession } from "../embedded/execution-context.js";
+import { assertTaskHandoffAccess, assertTaskHandoffExecutorAccess, getTaskHandoff, materializeTaskHandoffFile, readTaskHandoffSource } from "../../tasks/task-handoff.js";
 import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";
 import { taskResearchEvidence } from "../../tasks/task-research-result.js";
-import { assertTaskHandoffAccess, assertTaskHandoffExecutorAccess, getTaskHandoff, materializeTaskHandoffFile, readTaskHandoffSource } from "../../tasks/task-handoff.js";
 import { createXopcUseTool } from "./xopc-use-tool.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/task-collaboration-tool.ts

package/dist/src/agent/tools/tool-manual-tool.d.ts

@@ -1,7 +1,7 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 declare const ToolManualSchema: import("@sinclair/typebox").TObject<{
     tool: import("@sinclair/typebox").TString;
-    topic: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"agent">, import("@sinclair/typebox").TLiteral<"settings">, import("@sinclair/typebox").TLiteral<"automation">, import("@sinclair/typebox").TLiteral<"connections">, import("@sinclair/typebox").TLiteral<"browser_setup">, import("@sinclair/typebox").TLiteral<"phone_setup">]>>;
+    topic: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"mcp">, import("@sinclair/typebox").TLiteral<"skills">, import("@sinclair/typebox").TLiteral<"agent">, import("@sinclair/typebox").TLiteral<"settings">, import("@sinclair/typebox").TLiteral<"automation">, import("@sinclair/typebox").TLiteral<"connections">, import("@sinclair/typebox").TLiteral<"browser_setup">, import("@sinclair/typebox").TLiteral<"phone_setup">]>>;
 }>;
 export declare function createToolManualTool(): AgentTool<typeof ToolManualSchema, {}>;
 export {};

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

@@ -5,13 +5,15 @@ import { Type } from "@sinclair/typebox";
 const ToolManualSchema = Type.Object({
 	tool: Type.String({ description: "Built-in tool name, e.g. browser_use" }),
 	topic: Type.Optional(Type.Union([
+		Type.Literal("mcp"),
+		Type.Literal("skills"),
 		Type.Literal("agent"),
 		Type.Literal("settings"),
 		Type.Literal("automation"),
 		Type.Literal("connections"),
 		Type.Literal("browser_setup"),
 		Type.Literal("phone_setup")
-	], { description: "Focused xopc_use workflow; omit for the full parameter manual." }))
+	], { description: "Focused product workflow; omit for the full parameter manual." }))
 });
 function createToolManualTool() {
 	return {

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

@@ -12,6 +12,8 @@ const EAGER_CORE_TOOLS = new Set([
 	"skill_view",
 	"skills_list",
 	"tool_manual",
+	"mcp_setup",
+	"automation",
 	"publish_artifacts",
 	"task_collaboration",
 	"publish_task_result"

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

@@ -1,9 +1,9 @@
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
+import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
 import { writeWorkspaceFile } from "../sandbox/fileAccess.js";
 import { checkFileSafety } from "../prompt/safety.js";
 import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
-import { fileResourceId, fileSpaceId } from "../../files/file-service.js";
 import { basename, relative, sep } from "path";
 import { realpath } from "fs/promises";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/xopc-use-tool.d.ts

@@ -9,12 +9,12 @@ import type { LocalAppService } from '../../local-apps/index.js';
 import type { ChatPreviewService } from '../../chat-previews/index.js';
 import { TaskApplicationService } from '../../tasks/task-application-service.js';
 declare const XopcUseToolSchema: import("@sinclair/typebox").TObject<{
-    mode: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"context">, import("@sinclair/typebox").TLiteral<"project">, import("@sinclair/typebox").TLiteral<"automation">, import("@sinclair/typebox").TLiteral<"note">, import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"task_run">, import("@sinclair/typebox").TLiteral<"local_app">, import("@sinclair/typebox").TLiteral<"chat_preview">, import("@sinclair/typebox").TLiteral<"agent">, import("@sinclair/typebox").TLiteral<"settings">, import("@sinclair/typebox").TLiteral<"browser_setup">, import("@sinclair/typebox").TLiteral<"phone_setup">]>;
+    mode: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"context">, import("@sinclair/typebox").TLiteral<"project">, import("@sinclair/typebox").TLiteral<"automation">, import("@sinclair/typebox").TLiteral<"note">, import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"task_run">, import("@sinclair/typebox").TLiteral<"local_app">, import("@sinclair/typebox").TLiteral<"chat_preview">, import("@sinclair/typebox").TLiteral<"agent">, import("@sinclair/typebox").TLiteral<"settings">, import("@sinclair/typebox").TLiteral<"browser_setup">, import("@sinclair/typebox").TLiteral<"phone_setup">, import("@sinclair/typebox").TLiteral<"mcp_setup">]>;
     command: import("@sinclair/typebox").TString;
     args: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TAny>>;
     dryRun: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
 }>;
-export type XopcUseMode = 'context' | 'project' | 'automation' | 'note' | 'task' | 'task_run' | 'chat_preview' | 'local_app' | 'agent' | 'settings' | 'browser_setup' | 'phone_setup';
+export type XopcUseMode = 'context' | 'project' | 'automation' | 'note' | 'task' | 'task_run' | 'chat_preview' | 'local_app' | 'agent' | 'settings' | 'browser_setup' | 'phone_setup' | 'mcp_setup';
 export interface XopcUseToolInput {
     mode: XopcUseMode;
     command: string;
@@ -23,8 +23,10 @@ export interface XopcUseToolInput {
 }
 export interface XopcUseToolDeps {
     canConfigureFromConversation?: () => boolean;
+    canRequestWeixinMcpSetup?: () => boolean;
     getPhoneSetupService?: () => import('../../phone/setup/service.js').PhoneSetupService | undefined;
     getBrowserSetupService?: () => import('../../browser/setup/service.js').BrowserSetupService | undefined;
+    getMcpSetupService?: () => import('../mcp/conversation-setup.js').McpConversationSetup | undefined;
     authorizeCapability?: CapabilityContext['authorize'];
     getWorkspace?: () => string;
     getConfig?: () => Config | undefined;