@xopcai/xopc 0.0.364 → 0.0.367

package/dist/src/agent/image/generation/runtime.js

@@ -1,11 +1,13 @@
 import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
 import { PROVIDER_ENV_MAP, init_env_keys } from "../../../providers/env-keys.js";
+import { ImageProviderError } from "../../../../packages/image-providers/src/validation.js";
+import "../../../../packages/image-providers/src/index.js";
 import { describeFailoverError, isFailoverError } from "../../failover-error.js";
-import { buildMediaGenerationNormalizationMetadata, buildNoCapabilityModelConfiguredMessage, recordCapabilityCandidateFailure, resolveCapabilityModelCandidates, throwCapabilityGenerationFailure } from "../../media-generation/runtime-shared.js";
+import { buildNoCapabilityModelConfiguredMessage, recordCapabilityCandidateFailure, resolveCapabilityModelCandidates, throwCapabilityGenerationFailure } from "../../media-generation/runtime-shared.js";
 import "../../media-generation/index.js";
 import { parseImageGenerationModelRef } from "./model-ref.js";
-import { resolveImageGenerationOverrides } from "./normalization.js";
+import { validateImageGenerationRequest } from "./validation.js";
 import { getImageGenerationProvider, listImageGenerationProviders, listImageGenerationProvidersSummary as listImageGenerationProvidersSummary$1 } from "./provider-registry.js";
 //#region src/agent/image/generation/runtime.ts
 init_env_keys();
@@ -29,9 +31,13 @@ async function generateImage(params, deps = {}) {
 		autoProviderFallback: params.autoProviderFallback
 	});
 	if (candidates.length === 0) throw new Error(buildNoImageGenerationModelConfiguredMessage(params.cfg, deps));
+	params = {
+		...params,
+		signal: AbortSignal.any([AbortSignal.timeout(params.timeoutMs ?? 6e5), ...params.signal ? [params.signal] : []])
+	};
 	const attempts = [];
 	let lastError;
-	for (const candidate of candidates) {
+	for (const candidate of candidates.slice(0, 3)) {
 		const startedAt = Date.now();
 		const provider = getProvider(candidate.provider, params.cfg);
 		if (!provider) {
@@ -51,13 +57,15 @@ async function generateImage(params, deps = {}) {
 			continue;
 		}
 		try {
+			if (!provider.models.includes(candidate.model)) throw new ImageProviderError(`Unsupported image model: ${candidate.model}`, 400);
 			const modelCapabilities = provider.modelCapabilities?.[candidate.model];
-			const sanitized = resolveImageGenerationOverrides({
+			validateImageGenerationRequest({
 				provider: modelCapabilities ? {
 					...provider,
 					capabilities: modelCapabilities
 				} : provider,
 				size: params.size,
+				count: params.count,
 				aspectRatio: params.aspectRatio,
 				resolution: params.resolution,
 				quality: params.quality,
@@ -68,32 +76,29 @@ async function generateImage(params, deps = {}) {
 			const request = buildProviderRequest({
 				provider,
 				candidate,
-				params,
-				sanitized
+				params
 			});
 			log.debug({
 				provider: candidate.provider,
 				model: candidate.model,
-				phase: "provider_invoked",
-				normalizationCount: sanitized.normalization ? Object.keys(sanitized.normalization).length : 0,
-				ignoredCount: sanitized.ignoredOverrides.length
+				phase: "provider_invoked"
 			}, `image-generation provider invoked: ${candidate.provider}/${candidate.model}`);
 			const result = await provider.generateImage(request);
 			if (!result.images?.length) throw new Error("Image generation provider returned no images.");
-			const normalizationMetadata = buildMediaGenerationNormalizationMetadata({ normalization: sanitized.normalization });
 			return {
 				images: result.images,
 				provider: candidate.provider,
 				model: result.model ?? candidate.model,
 				attempts,
-				...sanitized.normalization ? { normalization: sanitized.normalization } : {},
-				ignoredOverrides: sanitized.ignoredOverrides,
-				metadata: {
-					...result.metadata ?? {},
-					...normalizationMetadata
-				}
+				metadata: result.metadata
 			};
 		} catch (err) {
+			const status = err && typeof err === "object" && "status" in err ? err.status : void 0;
+			if (params.signal?.aborted || err instanceof ImageProviderError && !err.retryable || ![
+				401,
+				403,
+				429
+			].includes(Number(status))) throw err;
 			lastError = err;
 			const durationMs = Date.now() - startedAt;
 			recordCapabilityCandidateFailure({
@@ -127,7 +132,7 @@ function listImageGenerationProvidersSummary() {
 	return listImageGenerationProvidersSummary$1();
 }
 function buildProviderRequest(input) {
-	const { provider, candidate, params, sanitized } = input;
+	const { provider, candidate, params } = input;
 	const inputImages = params.inputImages ? cloneInputImages(params.inputImages) : void 0;
 	return {
 		provider: provider.id,
@@ -140,12 +145,12 @@ function buildProviderRequest(input) {
 		...typeof params.timeoutMs === "number" ? { timeoutMs: params.timeoutMs } : {},
 		...params.signal ? { signal: params.signal } : {},
 		...typeof params.count === "number" ? { count: params.count } : {},
-		...sanitized.size !== void 0 ? { size: sanitized.size } : {},
-		...sanitized.aspectRatio !== void 0 ? { aspectRatio: sanitized.aspectRatio } : {},
-		...sanitized.resolution !== void 0 ? { resolution: sanitized.resolution } : {},
-		...sanitized.quality !== void 0 ? { quality: sanitized.quality } : {},
-		...sanitized.outputFormat !== void 0 ? { outputFormat: sanitized.outputFormat } : {},
-		...sanitized.background !== void 0 ? { background: sanitized.background } : {},
+		...params.size !== void 0 ? { size: params.size } : {},
+		...params.aspectRatio !== void 0 ? { aspectRatio: params.aspectRatio } : {},
+		...params.resolution !== void 0 ? { resolution: params.resolution } : {},
+		...params.quality !== void 0 ? { quality: params.quality } : {},
+		...params.outputFormat !== void 0 ? { outputFormat: params.outputFormat } : {},
+		...params.background !== void 0 ? { background: params.background } : {},
 		...inputImages ? { inputImages } : {},
 		...params.providerOptions ? { providerOptions: params.providerOptions } : {}
 	};

package/dist/src/agent/image/generation/types.d.ts

@@ -1,48 +1,11 @@
 import type { Config } from '../../../config/schema.js';
 import type { AuthProfileStore } from '../../../providers/auth-runtime/index.js';
-import type { MediaNormalizationEntry } from '../../media-generation/normalization.types.js';
 export type ImageGenerationResolution = '1K' | '2K' | '4K';
-export type ImageGenerationQuality = 'low' | 'medium' | 'high' | 'auto';
+export type ImageGenerationQuality = 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'auto';
 export type ImageGenerationOutputFormat = 'png' | 'jpeg' | 'webp';
 export type ImageGenerationBackground = 'transparent' | 'opaque' | 'auto';
-/** Generation-mode (text → image) capability slice. */
-export interface ImageGenerationGenerateCapability {
-    /** Maximum images per call (defaults to 1 when omitted). */
-    maxCount?: number;
-    /** Provider supports an explicit `size` parameter. */
-    supportsSize?: boolean;
-    /** Provider supports `aspectRatio` parameter. */
-    supportsAspectRatio?: boolean;
-    /** Provider supports `resolution` parameter. */
-    supportsResolution?: boolean;
-}
-/** Edit-mode (image → image) capability slice. */
-export interface ImageGenerationEditCapability {
-    enabled: boolean;
-    /** Max number of input reference images (1 = single ref). */
-    maxInputImages?: number;
-    supportsSize?: boolean;
-    supportsAspectRatio?: boolean;
-}
-/** Geometry constraints (allowed values for size / aspectRatio / resolution). */
-export interface ImageGenerationGeometryCapability {
-    sizes?: string[];
-    aspectRatios?: string[];
-    resolutions?: ImageGenerationResolution[];
-}
-/** Output / styling capability slice. */
-export interface ImageGenerationOutputCapability {
-    qualities?: ImageGenerationQuality[];
-    formats?: ImageGenerationOutputFormat[];
-    backgrounds?: ImageGenerationBackground[];
-}
-/** New nested capability shape. */
-export interface ImageGenerationProviderCapabilities {
-    generate?: ImageGenerationGenerateCapability;
-    edit?: ImageGenerationEditCapability;
-    geometry?: ImageGenerationGeometryCapability;
-    output?: ImageGenerationOutputCapability;
-}
+export type { ImageGeometry as ImageGenerationGeometryCapability } from '../../../../packages/image-providers/src/types.js';
+export type ImageGenerationProviderCapabilities = import('../../../../packages/image-providers/src/types.js').ImageCapabilities;
 export interface ImageGenerationProviderConfiguredContext {
     cfg?: Config;
     agentId?: string;
@@ -112,16 +75,6 @@ export interface ImageGenerationSourceImage {
     fileName?: string;
     metadata?: Record<string, unknown>;
 }
-export type ImageGenerationIgnoredOverrideKey = 'size' | 'aspectRatio' | 'resolution' | 'quality' | 'outputFormat' | 'background';
-export interface ImageGenerationIgnoredOverride {
-    key: ImageGenerationIgnoredOverrideKey;
-    value: string;
-}
-export interface ImageGenerationNormalization {
-    size?: MediaNormalizationEntry<string>;
-    aspectRatio?: MediaNormalizationEntry<string>;
-    resolution?: MediaNormalizationEntry<ImageGenerationResolution>;
-}
 export interface ImageGenerationRequest {
     provider: string;
     model: string;

package/dist/src/agent/image/generation/validation.d.ts

@@ -0,0 +1,6 @@
+import type { ImageGenerationProvider, ImageGenerationRequest } from './types.js';
+export interface ImageGenerationValidationParams extends Pick<ImageGenerationRequest, 'size' | 'count' | 'aspectRatio' | 'resolution' | 'quality' | 'outputFormat' | 'background' | 'inputImages'> {
+    provider: ImageGenerationProvider;
+}
+export declare function validateImageGenerationRequest(params: ImageGenerationValidationParams): void;
+export type { ImageGenerationProviderCapabilities } from './types.js';

package/dist/src/agent/image/generation/validation.js

@@ -0,0 +1,16 @@
+import { validateImageRequest } from "../../../../packages/image-providers/src/validation.js";
+import "../../../../packages/image-providers/src/index.js";
+//#region src/agent/image/generation/validation.ts
+function validateImageGenerationRequest(params) {
+	validateImageRequest({
+		...params,
+		model: params.provider.defaultModel,
+		prompt: "validate",
+		inputImages: params.inputImages?.map((image, index) => ({
+			blob: new Blob([new Uint8Array(image.buffer)], { type: image.mimeType }),
+			fileName: image.fileName ?? `image-${index}`
+		}))
+	}, params.provider.capabilities);
+}
+//#endregion
+export { validateImageGenerationRequest };

package/dist/src/agent/inbound/attachment-pipeline.js

@@ -1,10 +1,10 @@
 import { stripRuntimeUserMessageEnvelope } from "../../../packages/gateway-contract/src/user-message-display.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { extractProfileAgentId } from "../../config/agent-profile.js";
+import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { mimeTypeFromMediaPath } from "../../media/store.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { readMediaReference } from "../../media/media-reference.js";
-import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { isImageInboundAttachment } from "../../channels/attachments/attachment-classifiers.js";
 import "../../channels/attachments/inbound-persist.js";
 import { expandAtFileMentionsInPlainText } from "../context/expand-at-file-mentions.js";

package/dist/src/agent/prompt/voice-presentation.d.ts

@@ -1,2 +1,2 @@
 /** Per-turn presentation only; never persisted as a user message or Agent identity. */
-export declare const voicePresentationPrompt = "This turn is a live voice conversation in the same Chat.\nLead with the useful answer. Prefer one to three natural spoken sentences unless the user asks for detail.\nAllow silence. Do not repeatedly greet, recap unrelated old tasks, or end every reply with a question.\nFor work, briefly say what you are doing, use the available tools, then report the actual result.\nKeep code, long URLs, tables and detailed reference material in Chat; introduce them with a short spoken explanation.\nDo not imply a task continues in the background unless an existing task or workflow actually started it.\nUse the existing clarification and approval mechanisms. A background sound or ambiguous interjection is not permission for an action.\nStopping speech does not undo a completed tool action. State consequential results accurately.";
+export declare const voicePresentationPrompt = "This turn is a live voice conversation in the same Chat.\nLead with the useful answer. Prefer one to three natural spoken sentences unless the user asks for detail.\nAllow silence. Do not repeatedly greet, recap unrelated old tasks, or end every reply with a question.\nFor work, briefly say what you are doing, use the available tools, then report the actual result.\nKeep code, long URLs, tables and detailed reference material in Chat; introduce them with a short spoken explanation.\nDo not imply a task continues in the background unless an existing task or workflow actually started it.\nAsk ordinary follow-up questions directly in speech, then let the user answer in the next turn; do not use a blocking clarification form. Keep formal action approvals in the existing approval mechanism. A background sound or ambiguous interjection is not permission for an action.\nStopping speech does not undo a completed tool action. State consequential results accurately.";

package/dist/src/agent/prompt/voice-presentation.js

@@ -6,7 +6,7 @@ Allow silence. Do not repeatedly greet, recap unrelated old tasks, or end every
 For work, briefly say what you are doing, use the available tools, then report the actual result.
 Keep code, long URLs, tables and detailed reference material in Chat; introduce them with a short spoken explanation.
 Do not imply a task continues in the background unless an existing task or workflow actually started it.
-Use the existing clarification and approval mechanisms. A background sound or ambiguous interjection is not permission for an action.
+Ask ordinary follow-up questions directly in speech, then let the user answer in the next turn; do not use a blocking clarification form. Keep formal action approvals in the existing approval mechanism. A background sound or ambiguous interjection is not permission for an action.
 Stopping speech does not undo a completed tool action. State consequential results accurately.`;
 //#endregion
 export { voicePresentationPrompt };

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

@@ -1,10 +1,12 @@
 import { getClarificationResumeInput, init_clarification_wait_repository } from "../../storage/sqlite/clarification-wait-repository.js";
 import { getConnectionResumeInput, init_connection_wait_repository } from "../../storage/sqlite/connection-wait-repository.js";
+import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { resolveImageHandlingStrategy } from "../image/vision-detection.js";
 import { hydrateUserTurnForLlm } from "../inbound/attachment-pipeline.js";
 import { buildDelegatedTaskDirective, buildTaskExecutionDirective } from "../../tasks/task-context-assembler.js";
 import { shouldSkipResetOverlapCommand } from "../../session/reset-triggers.js";
 import { parseSlashCommand } from "../../chat-commands/command-parse.js";
+import { personalCommandRejection } from "../../chat-commands/personal-command-policy.js";
 import { commandRegistry } from "../../chat-commands/registry.js";
 import "../../chat-commands/index.js";
 import { runEmbeddedTurnForSession } from "../embedded/run-for-session.js";
@@ -33,11 +35,25 @@ async function hydratePerTurnState(deps, conversationId, thinking) {
 * can persist the receipt or stream it as a token.
 */
 async function tryRunSlashCommand(deps, ctx, content, options) {
-	const parsed = parseSlashCommand(content);
+	const personal = isPersonalConversation(ctx.conversationId);
+	const parsed = personal ? /^\/[a-z][a-z0-9_:-]*(?:\s|$)/i.test(content.trim()) ? parseSlashCommand(content.trim().split(/\r?\n/)[0]) : null : parseSlashCommand(content);
 	if (!parsed) return {
 		matched: false,
 		aggregatedText: ""
 	};
+	if (personal) {
+		const command = commandRegistry.findByName(parsed.command);
+		if (!command && !parsed.command.startsWith("skill:")) return {
+			matched: false,
+			aggregatedText: ""
+		};
+		const rejection = personalCommandRejection(ctx.conversationId, command?.id ?? "skill.invoke", parsed.command);
+		if (rejection) return {
+			matched: true,
+			aggregatedText: rejection,
+			command: parsed.command
+		};
+	}
 	if (options?.skipResetCommands && shouldSkipResetOverlapCommand(parsed.command, true)) return {
 		matched: false,
 		aggregatedText: ""

package/dist/src/agent/service.js

@@ -2,22 +2,22 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_attachment_ref, parseNoteAttachmentTarget } from "../notes/attachment-ref.js";
 import { init_agent_scope, resolveAgentHomeDir, resolveDefaultAgentId } from "./agent-scope.js";
-import { extractTextContent } from "./context/workspace.js";
 import { configureTracing, flushTracing } from "../observability/runtime.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../routing/agent-session-key.js";
 import { extractProfileAgentId, resolveEffectiveAgentConfigForSession } from "../config/agent-profile.js";
 import { init_providers, resolveModel } from "../providers/index.js";
+import { extractTextContent } from "./context/workspace.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getProjectForSession } from "../projects/workspace.js";
+import { getUserTimezone } from "../user-model/repository.js";
+import "../user-model/index.js";
 import { runWithEmbeddedExecutionSession } from "./embedded/execution-context.js";
 import { removeSkillsLockEntry } from "./skills/hub-lock.js";
 import { installSkillFromZip } from "./skills/managed-store.js";
 import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "./skills/workspace-skills-dir.js";
 import { pullSkillFromSource } from "./skills/hub-pull.js";
-import { getUserTimezone } from "../user-model/repository.js";
-import "../user-model/index.js";
 import { resolveAgentTurnTimeoutMs } from "./orchestration/run-agent-turn-with-timeout.js";
 import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
 import { persistInboundAttachments } from "../channels/attachments/inbound-persist.js";

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

@@ -1,8 +1,8 @@
 import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { init_paths } from "../../config/paths.js";
+import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { findInstallSpec, hasBinary, installSkill } from "./installer.js";
 import { applySkillEnvOverrides, createSkillConfigManager, getSkillEnvironment, isSkillEnabled, resolveSkillConfig, validateSkillConfig } from "./config.js";
 import { parseSkillToolConditions } from "./skill-tool-gating.js";

package/dist/src/agent/skills/managed-store.js

@@ -1,5 +1,5 @@
-import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { init_paths, resolveSkillsDir } from "../../config/paths.js";
+import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { loadSkillsLock } from "./hub-lock.js";
 import { dirname, join, resolve, sep } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";

package/dist/src/agent/skills/skill-manage-ops.js

@@ -1,5 +1,5 @@
-import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { init_paths, resolveSkillsDir } from "../../config/paths.js";
+import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { resolveWorkspaceSkillsDir } from "./workspace-skills-dir.js";
 import { formatScanSummary, scanSkillDirectory } from "./scanner.js";
 import { fuzzyFindText, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings } from "../tools/edit-diff.js";

package/dist/src/agent/tools/delegation-parent-policy.js

@@ -9,6 +9,8 @@ function createDelegationParentPolicy(options) {
 		if (!options.getConfig()) return [];
 		const resolved = options.conversationId ? resolveEffectiveAgentConfigForSession(options.conversationId) : options.agentId ? resolveEffectiveAgentConfigForAgent(options.agentId) : resolveEffectiveAgentConfigForSession(void 0);
 		const names = [name];
+		const command = args?.command;
+		if ((name === "user_context_read" || name === "knowledge_read") && (command === "search" || command === "get")) names.push(`${name.slice(0, -5)}_${command}`);
 		if (name === "xopc_tool_execute") {
 			const parsed = parseExternalToolRef(String(args?.toolRef ?? ""), "mcp");
 			const ref = String(args?.toolRef ?? "");

package/dist/src/agent/tools/delegation-policy.js

@@ -23,6 +23,8 @@ const DELEGATION_TOOL_CAPABILITIES = {
 	web_search: "web_read",
 	web_fetch: "web_read",
 	web_extract: "web_read",
+	knowledge_read: "knowledge_read",
+	user_context_read: "knowledge_read",
 	knowledge_search: "knowledge_read",
 	knowledge_get: "knowledge_read",
 	session_search: "knowledge_read",

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

@@ -15,6 +15,7 @@ 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 PersonalTaskToolDeps } from './personal-task-tool.js';
 import type { MemoryManager } from '../memory/manager.js';
 import type { SessionStore } from '../../session/store.js';
 import type { GatewayClarifyRequestFn } from './clarify-tool.js';
@@ -47,6 +48,7 @@ export interface ToolFactoryDeps {
     getMemoryManager?: () => MemoryManager;
     /** Skill runtime for the current workspace/session. */
     getSkillManager?: () => SkillManager;
+    getAgentSkillAvailability?: PersonalTaskToolDeps['getAgentSkillAvailability'];
     /** Session store for `session_search`. */
     getSessionStore?: () => SessionStore;
     /** When set (gateway webchat), enables the `clarify` tool. */

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

@@ -10,7 +10,10 @@ import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/ses
 import { init_sqlite } from "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
+import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
+import { createPersonalAttentionTool } from "./personal-attention-tool.js";
 import "../../../packages/browser-control-contract/src/index.js";
+import { PERSONAL_TOOL_DESCRIPTIONS } from "../../personal-agent/policy.js";
 import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
 import { wrapToolsWithProtection } from "./executor.js";
 import { EXTERNAL_TOOL_NAMES } from "../external-tools/gateway-tools.js";
@@ -24,8 +27,8 @@ import { createListDirTool } from "./list-dir.js";
 import { createPublishArtifactsTool } from "./publish-artifacts.js";
 import { createExecCommandTool } from "./exec-command.js";
 import { createApplyPatchTool } from "./apply-patch.js";
-import { createUserContextGetTool, createUserContextSearchTool, createUserContextUpdateTool } from "./user-context-tool.js";
-import { createKnowledgeGetTool, createKnowledgeSearchTool, createKnowledgeWriteTool } from "./knowledge-memory-tool.js";
+import { createUserContextGetTool, createUserContextReadTool, createUserContextSearchTool, createUserContextUpdateTool } from "./user-context-tool.js";
+import { createKnowledgeGetTool, createKnowledgeReadTool, createKnowledgeSearchTool, createKnowledgeWriteTool } from "./knowledge-memory-tool.js";
 import { createSessionSearchTool } from "./session-search-tool.js";
 import { createSessionRecallTool } from "./session-recall-tool.js";
 import { createGrepTool } from "./grep.js";
@@ -68,7 +71,6 @@ import { createPersonalTaskTool } from "./personal-task-tool.js";
 import { createPersonalRequestTools } from "./personal-request-tool.js";
 import { createPersonalRequestConnectionTool, createPersonalRequestResultTool } from "./personal-request-result-tool.js";
 import { createPersonalPreferenceTool } from "./personal-preference-tool.js";
-import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
 import { createBrowserUseTool } from "./browser/tool/browser-use-tool.js";
 import { ComputerRuntime } from "../../computer/runtime.js";
 import { createComputerUseTool } from "./computer-use-tool.js";
@@ -294,6 +296,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 		const grep = createGrepTool(workspace);
 		const find = createFindTool(workspace);
 		const productToolDeps = {
+			getAgentSkillAvailability: this.deps.getAgentSkillAvailability,
 			getWorkspace: () => this.deps.workspace,
 			getConfig: () => this.deps.getConfig?.(),
 			getCurrentAgentId: () => options?.agentId,
@@ -412,6 +415,13 @@ var AgentToolsFactory = class AgentToolsFactory {
 				workspace,
 				getConfig: () => this.deps.getConfig?.()
 			})] : [],
+			...personalToolsConfigured || allowed?.has("user_context_read") ? [createUserContextReadTool({
+				agentId: resolvedAgentId,
+				workspaceId: workspace,
+				getSessionId: currentConversationId,
+				getProjectId: currentProjectId,
+				canRead: () => currentAccess().userModel
+			}, (command) => !disabled?.has(`user_context_${command}`) && (!isXopcDatabaseOpen() || resolveEffectiveAgentConfigForAgent(resolvedAgentId).config.tools[`user_context_${command}`]?.mode !== "deny"))] : [],
 			createUserContextSearchTool({
 				agentId: resolvedAgentId,
 				workspaceId: workspace,
@@ -438,6 +448,16 @@ var AgentToolsFactory = class AgentToolsFactory {
 					return conversationId ? getPendingTranscriptUserText(conversationId) : void 0;
 				}
 			}),
+			...personalToolsConfigured || allowed?.has("knowledge_read") ? [createKnowledgeReadTool({
+				agentId: resolvedAgentId,
+				workspaceId: workspace,
+				getSessionId: currentConversationId,
+				getProjectId: currentProjectId,
+				canRead: () => currentAccess().knowledge,
+				canWrite: () => currentAccess().knowledge,
+				getWritePolicy: knowledgeWritePolicy,
+				getReadPolicy: () => currentAccess().knowledgePolicy
+			}, (command) => !disabled?.has(`knowledge_${command}`) && (!isXopcDatabaseOpen() || resolveEffectiveAgentConfigForAgent(resolvedAgentId).config.tools[`knowledge_${command}`]?.mode !== "deny"))] : [],
 			createKnowledgeSearchTool({
 				agentId: resolvedAgentId,
 				workspaceId: workspace,
@@ -489,6 +509,10 @@ var AgentToolsFactory = class AgentToolsFactory {
 				createPersonalTaskTool(productToolDeps),
 				createPersonalReadTool(productToolDeps),
 				...createPersonalRequestTools(productToolDeps),
+				createPersonalAttentionTool({
+					getConversationId: () => this.deps.getCurrentContext()?.conversationId,
+					getConfig: () => this.deps.getConfig?.()
+				}),
 				createPersonalPreferenceTool({
 					getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId,
 					onAgentCatalogMutate: this.deps.onAgentCatalogMutate
@@ -591,7 +615,10 @@ var AgentToolsFactory = class AgentToolsFactory {
 				allowHostGit: () => getCommandIsolation()?.mode !== "docker"
 			}));
 		}
-		return filterToolsByDisabledSet(core, disabled).filter((tool) => !allowed || allowed.has(tool.name));
+		return filterToolsByDisabledSet(core, disabled).filter((tool) => (!allowed || allowed.has(tool.name)) && !(personalToolsConfigured && tool.name === "clarify")).map((tool) => personalToolsConfigured && PERSONAL_TOOL_DESCRIPTIONS[tool.name] ? {
+			...tool,
+			description: PERSONAL_TOOL_DESCRIPTIONS[tool.name]
+		} : tool);
 	}
 	createCapabilityTools(capabilityNames, options) {
 		const disabled = options?.disabledTools;

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

@@ -19,6 +19,8 @@ const ALLOWED_QUALITIES = [
 	"low",
 	"medium",
 	"high",
+	"xhigh",
+	"max",
 	"auto"
 ];
 const ALLOWED_OUTPUT_FORMATS = [
@@ -39,7 +41,7 @@ const ALLOWED_RESOLUTIONS = [
 const ImageGenerateToolSchema = Type.Object({
 	action: Type.Optional(Type.String({ description: "Optional: \"generate\" (default) or \"list\" available image-generation providers." })),
 	prompt: Type.Optional(Type.String({ description: "Image generation prompt." })),
-	model: Type.Optional(Type.String({ description: "Optional provider/model override, e.g. openai/gpt-image-2 / dashscope/wan2.7-image-pro / minimax/image-01." })),
+	model: Type.Optional(Type.String({ description: "Optional provider/model override, e.g. openai/gpt-image-2.5-flare / dashscope/wan2.7-image-pro / minimax/image-01." })),
 	filename: Type.Optional(Type.String({ description: "Optional basename hint for saved files." })),
 	size: Type.Optional(Type.String({ description: "Optional pixel size, e.g. 1024x1024." })),
 	aspectRatio: Type.Optional(Type.String({ description: "Optional aspect ratio, e.g. 16:9 / 9:16 / 1:1." })),
@@ -49,7 +51,7 @@ const ImageGenerateToolSchema = Type.Object({
 		maximum: MAX_COUNT,
 		description: `Number of images (1–${MAX_COUNT}).`
 	})),
-	quality: Type.Optional(Type.String({ description: "Optional quality: low / medium / high / auto." })),
+	quality: Type.Optional(Type.String({ description: "Optional quality: low / medium / high / xhigh / max / auto." })),
 	outputFormat: Type.Optional(Type.String({ description: "Optional output format: png / jpeg / webp." })),
 	background: Type.Optional(Type.String({ description: "Optional background: transparent / opaque / auto." })),
 	inputImages: Type.Optional(Type.Array(Type.Object({ source: Type.String({ description: "Workspace-relative file path or `data:image/...;base64,...` URL." }) }), { description: "Reference images for edit mode (provider must support edit)." })),
@@ -282,12 +284,10 @@ function createImageGenerateTool(options) {
 					filePath: paths[index],
 					mediaType: "photo"
 				})));
-				const lines = [`Generated and attached ${paths.length} image(s) with ${result.provider}/${result.model}.`, ...paths.map((p) => `Saved: ${p}`)];
-				for (const note of buildNormalizationNotes(result.normalization, result.ignoredOverrides)) lines.push(note);
 				return {
 					content: [{
 						type: "text",
-						text: lines.join("\n")
+						text: [`Generated and attached ${paths.length} image(s) with ${result.provider}/${result.model}.`, ...paths.map((p) => `Saved: ${p}`)].join("\n")
 					}],
 					details: {
 						provider: result.provider,
@@ -308,8 +308,6 @@ function createImageGenerateTool(options) {
 							workspaceRelativePath: workspaceRelativePaths[index]
 						})),
 						attempts: result.attempts,
-						...result.normalization ? { normalization: result.normalization } : {},
-						...result.ignoredOverrides.length > 0 ? { ignoredOverrides: result.ignoredOverrides } : {},
 						...result.metadata ? { metadata: result.metadata } : {}
 					}
 				};
@@ -337,17 +335,5 @@ function createImageGenerateTool(options) {
 		}
 	};
 }
-function buildNormalizationNotes(normalization, ignoredOverrides) {
-	const notes = [];
-	if (normalization) for (const [key, entry] of Object.entries(normalization)) {
-		if (!entry) continue;
-		const requested = entry.requested;
-		const applied = entry.applied;
-		if (requested !== void 0 && applied !== void 0 && requested !== applied) notes.push(`Note: requested ${key}="${requested}" → applied "${applied}".`);
-		else if (applied !== void 0 && entry.derivedFrom) notes.push(`Note: ${key}="${applied}" derived from ${entry.derivedFrom}.`);
-	}
-	for (const ig of ignoredOverrides) notes.push(`Note: ignored ${ig.key}="${ig.value}" (not supported by provider).`);
-	return notes;
-}
 //#endregion
 export { createImageGenerateTool, parseImageDataUrl, resolveImageGenerationModelConfigForTool };

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

@@ -6,8 +6,8 @@ export { createWriteFileTool, writeFileTool } from './write.js';
 export { createListDirTool, listDirTool } from './list-dir.js';
 export { createExecCommandTool, type ExecCommandDetails, type ExecCommandUpdateDetails, } from './exec-command.js';
 export { createApplyPatchTool, type AppliedPatchChange, type ApplyPatchDetails, } from './apply-patch.js';
-export { createUserContextSearchTool, createUserContextGetTool, createUserContextUpdateTool, type UserContextToolOptions, } from './user-context-tool.js';
-export { createKnowledgeSearchTool, createKnowledgeGetTool, createKnowledgeWriteTool, type KnowledgeToolOptions, } from './knowledge-memory-tool.js';
+export { createUserContextReadTool, createUserContextSearchTool, createUserContextGetTool, createUserContextUpdateTool, type UserContextToolOptions, } from './user-context-tool.js';
+export { createKnowledgeReadTool, createKnowledgeSearchTool, createKnowledgeGetTool, createKnowledgeWriteTool, type KnowledgeToolOptions, } from './knowledge-memory-tool.js';
 export { createSessionSearchTool } from './session-search-tool.js';
 export { createSessionRecallTool, type SessionRecallToolDeps } from './session-recall-tool.js';
 export { grepTool, createGrepTool, type GrepToolInput, type GrepToolDetails, } from './grep.js';

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

@@ -9,8 +9,8 @@ import { createPublishArtifactsTool } from "./publish-artifacts.js";
 import { createExecCommandTool } from "./exec-command.js";
 import { fuzzyFindText, generateDiffString, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings, stripBom } from "./edit-diff.js";
 import { createApplyPatchTool } from "./apply-patch.js";
-import { createUserContextGetTool, createUserContextSearchTool, createUserContextUpdateTool } from "./user-context-tool.js";
-import { createKnowledgeGetTool, createKnowledgeSearchTool, createKnowledgeWriteTool } from "./knowledge-memory-tool.js";
+import { createUserContextGetTool, createUserContextReadTool, createUserContextSearchTool, createUserContextUpdateTool } from "./user-context-tool.js";
+import { createKnowledgeGetTool, createKnowledgeReadTool, createKnowledgeSearchTool, createKnowledgeWriteTool } from "./knowledge-memory-tool.js";
 import { createSessionSearchTool } from "./session-search-tool.js";
 import { createSessionRecallTool } from "./session-recall-tool.js";
 import { createGrepTool, grepTool } from "./grep.js";
@@ -46,4 +46,4 @@ import { createManagedJobTool } from "./managed-job-tool.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
 import { createPersonalReadTool } from "./personal-read-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, createKnowledgeSearchTool, createKnowledgeWriteTool, createListDirTool, createManagedJobTool, createMemoryMaintenanceTool, createMessageTool, createPersonalReadTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, createUserContextSearchTool, createUserContextUpdateTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowManageTool, createWorkflowTool, 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, createMemoryMaintenanceTool, createMessageTool, createPersonalReadTool, createPublishArtifactsTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionRecallTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createUserContextGetTool, createUserContextReadTool, createUserContextSearchTool, createUserContextUpdateTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowManageTool, createWorkflowTool, 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/knowledge-memory-tool.d.ts

@@ -13,3 +13,5 @@ export interface KnowledgeToolOptions {
 export declare function createKnowledgeSearchTool(options: KnowledgeToolOptions): AgentTool;
 export declare function createKnowledgeGetTool(options: KnowledgeToolOptions): AgentTool;
 export declare function createKnowledgeWriteTool(options: KnowledgeToolOptions): AgentTool;
+/** Combines bounded reads while preserving the original visibility and policy checks. */
+export declare function createKnowledgeReadTool(options: KnowledgeToolOptions, canUseCommand?: (command: 'search' | 'get') => boolean): AgentTool;