@xopcai/xopc 0.0.364 → 0.0.366

package/dist/gateway/static/root/index.html

@@ -11,7 +11,7 @@
     <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png?v=20260910-1" />
     <link rel="manifest" href="/site.webmanifest?v=20260910-1" />
     <title>XOPC — Keep what matters moving.</title>
-    <script type="module" crossorigin src="/assets/index-BpXej9jJ.js"></script>
+    <script type="module" crossorigin src="/assets/index-6JNNrzCq.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-aKtaBQYM.js">
     <link rel="modulepreload" crossorigin href="/assets/preload-helper-zJ_50EbN.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-react-BOUWij0V.js">
@@ -25,15 +25,15 @@
     <link rel="modulepreload" crossorigin href="/assets/download-Dk-ZjtO6.js">
     <link rel="modulepreload" crossorigin href="/assets/plus-Q2yW6OE7.js">
     <link rel="modulepreload" crossorigin href="/assets/x-B_N4OPjy.js">
-    <link rel="modulepreload" crossorigin href="/assets/messages-BHvpZNe9.js">
-    <link rel="modulepreload" crossorigin href="/assets/locale-store-DId6-v2R.js">
+    <link rel="modulepreload" crossorigin href="/assets/messages-pGa2qMzG.js">
+    <link rel="modulepreload" crossorigin href="/assets/locale-store-CvNO-hbt.js">
     <link rel="modulepreload" crossorigin href="/assets/cn-JdwAhgNB.js">
     <link rel="modulepreload" crossorigin href="/assets/schemas-CObaziC7.js">
     <link rel="modulepreload" crossorigin href="/assets/local-apps-yys1VChX.js">
     <link rel="modulepreload" crossorigin href="/assets/product-delivery-BAks11S4.js">
     <link rel="modulepreload" crossorigin href="/assets/app-link-DRL0YnPs.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-to-clipboard-HOJ79TWv.js">
-    <link rel="modulepreload" crossorigin href="/assets/markdown-view-DQZ51j9e.js">
+    <link rel="modulepreload" crossorigin href="/assets/markdown-view-DDJlD5jR.js">
     <link rel="modulepreload" crossorigin href="/assets/dist-Che_jiQF.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-swr-BIWyz7Rc.js">
     <link rel="modulepreload" crossorigin href="/assets/activity-YogQEteU.js">
@@ -59,7 +59,7 @@
     <link rel="modulepreload" crossorigin href="/assets/form-field-width-DJw_jULe.js">
     <link rel="modulepreload" crossorigin href="/assets/interaction-BdhHBbYa.js">
     <link rel="modulepreload" crossorigin href="/assets/is-masked-secret-DOkL5b_X.js">
-    <link rel="modulepreload" crossorigin href="/assets/secret-input-DPl3VYM8.js">
+    <link rel="modulepreload" crossorigin href="/assets/secret-input-D93UrW4C.js">
     <link rel="modulepreload" crossorigin href="/assets/mic-CuUb7zc-.js">
     <link rel="modulepreload" crossorigin href="/assets/folder-open-CyzJ19I9.js">
     <link rel="modulepreload" crossorigin href="/assets/link-2-D_ZKYUW7.js">
@@ -69,30 +69,30 @@
     <link rel="modulepreload" crossorigin href="/assets/rotate-cw-LIg3Am9S.js">
     <link rel="modulepreload" crossorigin href="/assets/search-DA7gz22f.js">
     <link rel="modulepreload" crossorigin href="/assets/index.module-Cd9ENXfk.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-FDS6S6qa.js">
-    <link rel="modulepreload" crossorigin href="/assets/session-api-N3N37MrR.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-D_EwU7-6.js">
+    <link rel="modulepreload" crossorigin href="/assets/session-api-CW2X7g_U.js">
     <link rel="modulepreload" crossorigin href="/assets/constants-Dy8Gw0sF.js">
     <link rel="modulepreload" crossorigin href="/assets/app-chrome-BeB4KgOf.js">
     <link rel="modulepreload" crossorigin href="/assets/attachment-utils-core-BIOUBrpT.js">
     <link rel="modulepreload" crossorigin href="/assets/files-Bw4SBGdM.js">
-    <link rel="modulepreload" crossorigin href="/assets/workspace-api-Cs4sjV2A.js">
+    <link rel="modulepreload" crossorigin href="/assets/workspace-api-B9M9ECTB.js">
     <link rel="modulepreload" crossorigin href="/assets/electron-env-Dit0bHgy.js">
     <link rel="modulepreload" crossorigin href="/assets/use-async-resource-GrnWNwMZ.js">
-    <link rel="modulepreload" crossorigin href="/assets/activity-store-GvR2gZ0T.js">
-    <link rel="modulepreload" crossorigin href="/assets/use-file-preview-expanded-Bope6MW6.js">
+    <link rel="modulepreload" crossorigin href="/assets/activity-store-SVmnh__i.js">
+    <link rel="modulepreload" crossorigin href="/assets/use-file-preview-expanded-BOpcSApw.js">
     <link rel="modulepreload" crossorigin href="/assets/globe-DSSGFWFn.js">
     <link rel="modulepreload" crossorigin href="/assets/button-CS04eWY9.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-text-row-BHDs3cBa.js">
-    <link rel="modulepreload" crossorigin href="/assets/share-link-dialog-TBBGJPfT.js">
-    <link rel="modulepreload" crossorigin href="/assets/local-session-drafts-gbemPamv.js">
+    <link rel="modulepreload" crossorigin href="/assets/share-link-dialog-DCSmx-Rl.js">
+    <link rel="modulepreload" crossorigin href="/assets/local-session-drafts-C4et6msJ.js">
     <link rel="modulepreload" crossorigin href="/assets/tasks-CH6KoBeY.js">
-    <link rel="modulepreload" crossorigin href="/assets/capabilities-CT_ZW9fT.js">
+    <link rel="modulepreload" crossorigin href="/assets/capabilities-C4grvUkw.js">
     <link rel="modulepreload" crossorigin href="/assets/skill-wire-pattern-BPpeIcCi.js">
-    <link rel="modulepreload" crossorigin href="/assets/shares-api-DU0fHP2G.js">
-    <link rel="modulepreload" crossorigin href="/assets/capabilities-BKu9BqPe.js">
-    <link rel="modulepreload" crossorigin href="/assets/use-composer-attachments-DB0bBGzZ.js">
+    <link rel="modulepreload" crossorigin href="/assets/shares-api-B4rLfG3l.js">
+    <link rel="modulepreload" crossorigin href="/assets/capabilities-CAIQmCrH.js">
+    <link rel="modulepreload" crossorigin href="/assets/use-composer-attachments-Dlm9EFTO.js">
     <link rel="modulepreload" crossorigin href="/assets/git-branch-Dh9uxTot.js">
-    <link rel="modulepreload" crossorigin href="/assets/notes-api-Byt65v3r.js">
+    <link rel="modulepreload" crossorigin href="/assets/notes-api-CKLw9vjk.js">
     <link rel="modulepreload" crossorigin href="/assets/message-square-fVE7Ghj1.js">
     <link rel="modulepreload" crossorigin href="/assets/pause-DuPxgSxk.js">
     <link rel="modulepreload" crossorigin href="/assets/play-kxZvpBg8.js">
@@ -100,19 +100,19 @@
     <link rel="modulepreload" crossorigin href="/assets/settings-2-D-csvaET.js">
     <link rel="modulepreload" crossorigin href="/assets/sparkles-DHlfQFAF.js">
     <link rel="modulepreload" crossorigin href="/assets/middleware-Pd0e8Igk.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-realtime-store-DBvCRclh.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-realtime-D0ygm6bc.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-realtime-store-DeUVEPPE.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-realtime-DD70L42G.js">
     <link rel="modulepreload" crossorigin href="/assets/tool-activity-BtJkgjFf.js">
-    <link rel="modulepreload" crossorigin href="/assets/registry-api-7F2WNEZC.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-CoRoOG1l.js">
-    <link rel="modulepreload" crossorigin href="/assets/agents-admin-api-BkXb7VEZ.js">
-    <link rel="modulepreload" crossorigin href="/assets/session-manager-CMGUwtbN.js">
-    <link rel="modulepreload" crossorigin href="/assets/send-session-input-D1oc6BC6.js">
-    <link rel="modulepreload" crossorigin href="/assets/theme-store-OhcbFEUR.js">
-    <link rel="modulepreload" crossorigin href="/assets/extension-provider-F9JzOWZ3.js">
+    <link rel="modulepreload" crossorigin href="/assets/registry-api-CiN49wvk.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-config-swr-DIIzvDLQ.js">
+    <link rel="modulepreload" crossorigin href="/assets/agents-admin-api-CVdFV-cU.js">
+    <link rel="modulepreload" crossorigin href="/assets/session-manager-BDpdi3lF.js">
+    <link rel="modulepreload" crossorigin href="/assets/send-session-input-jH6MQwdZ.js">
+    <link rel="modulepreload" crossorigin href="/assets/theme-store-DbRLBHVY.js">
+    <link rel="modulepreload" crossorigin href="/assets/extension-provider-DaLt3bC-.js">
     <link rel="modulepreload" crossorigin href="/assets/loopi-Djb8XU3l.js">
-    <link rel="modulepreload" crossorigin href="/assets/models-hub-cache-B9SKjidc.js">
-    <link rel="modulepreload" crossorigin href="/assets/oauth-api-BYsCbyGZ.js">
+    <link rel="modulepreload" crossorigin href="/assets/models-hub-cache-DzFiL4xV.js">
+    <link rel="modulepreload" crossorigin href="/assets/oauth-api-CC5KkSgG.js">
     <link rel="modulepreload" crossorigin href="/assets/skill-api-utils-C7V4JVXM.js">
     <link rel="modulepreload" crossorigin href="/assets/settings-form-draft-Dy10ldo8.js">
     <link rel="stylesheet" crossorigin href="/assets/markdown-view-DSjfHfaW.css">

package/dist/package.js

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.0.364";
+var version = "0.0.366";
 //#endregion
 export { version };

package/dist/packages/gateway-contract/src/session-input-command.js

@@ -86,6 +86,7 @@ var init_session_input_command = __esmMin((() => {
 		expectedTranscriptId: z.string().min(1).max(128),
 		configVersion: z.number().int().nonnegative(),
 		delivery: z.enum(["next", "steer"]),
+		interrupt: z.boolean().optional(),
 		input: sessionInputContentSchema,
 		origin: originSchema
 	})]);

package/dist/src/agent/agent-manager.d.ts

@@ -288,6 +288,7 @@ export declare class AgentManager implements AgentInstanceGateway {
     refreshCredentials(): Promise<void>;
     private resolveApiKeyWithCache;
     private composeDynamicProjectContext;
+    private readonly personalPromptContext;
     private buildExecutionScopeContext;
     private getInteractionStateVersion;
     private getUserContextAccessVersion;

package/dist/src/agent/agent-manager.js

@@ -8,7 +8,6 @@ import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js
 import { init_sqlite } from "../storage/sqlite/index.js";
 import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
 import { init_agent_scope, listAgentEntries, resolveAgentProfileDir } from "./agent-scope.js";
-import { extractTextContent } from "./context/workspace.js";
 import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
 import { traceTools } from "../observability/runtime.js";
@@ -19,6 +18,10 @@ import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync
 import { getApiKeySync, getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
 import { continuesAfterTool, trackAiUsageStream } from "../usage/recorder.js";
+import { extractTextContent } from "./context/workspace.js";
+import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
+import { isPersonalConversation } from "../personal-agent/repository.js";
+import { PersonalPromptContext } from "../personal-agent/prompt-context.js";
 import { buildExecutionScopeContextForPrompt } from "./context/execution-scope.js";
 import { clearBootstrapSnapshot } from "./bootstrap/bootstrap-cache.js";
 import { resolveBootstrapContextSync } from "./bootstrap/bootstrap-files.js";
@@ -35,7 +38,6 @@ import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "./ski
 import { replaceAgentSystemPrompt } from "./prompt/agent-system-prompt.js";
 import { evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner } from "./embedded/session-runner.js";
 import { createAgentTurnPolicy } from "./orchestration/agent-turn-policy.js";
-import { resolveUserContextSessionAccess } from "../user-context/access-policy.js";
 import { createAgentCapabilitySessionState, resolveAgentCapabilityCatalog } from "./capabilities/registry.js";
 import "./capabilities/index.js";
 import { sortToolsForPromptCache } from "./tools/cache-stability.js";
@@ -258,6 +260,7 @@ var AgentManager = class {
 			getPrimaryModel: () => this.resolveModelStringToModel(this.pickDefaultModelRef()),
 			getMemoryManager: () => this.getCurrentWorkspaceRuntime().memoryManager,
 			getSkillManager: () => this.getCurrentWorkspaceRuntime().skillManager,
+			getAgentSkillAvailability: (agentId) => this.getAgentSkillAvailability(agentId),
 			getSessionStore: this.config.getSessionStore,
 			gatewayClarify: this.config.gatewayClarify,
 			getAutomationService: this.config.getAutomationService,
@@ -393,7 +396,7 @@ var AgentManager = class {
 	prepareSkillTurn(conversationId, text) {
 		this.getOrCreateAgent(conversationId);
 		const inst = this.agents.get(conversationId);
-		if (!text.includes("/skill:")) return {
+		if (isPersonalConversation(conversationId) || !text.includes("/skill:")) return {
 			text,
 			activatedCapabilityNames: this.activeCapabilityNames(inst)
 		};
@@ -969,7 +972,9 @@ var AgentManager = class {
 	composeDynamicProjectContext(...sections) {
 		return sections.map((section) => section?.trim()).filter((section) => Boolean(section)).join("\n\n") || void 0;
 	}
+	personalPromptContext = new PersonalPromptContext();
 	buildExecutionScopeContext(conversationId) {
+		if (isXopcDatabaseOpen() && isPersonalConversation(conversationId)) return this.personalPromptContext.build(this.config.config, conversationId);
 		const access = resolveUserContextSessionAccess(this.config.config, conversationId);
 		return buildExecutionScopeContextForPrompt(conversationId, {
 			includeKnowledge: access.knowledge,
@@ -1133,6 +1138,33 @@ var AgentManager = class {
 	}
 	resolveToolPolicy(profile, toolName, args) {
 		const gatewayPolicy = profile.config.tools[toolName];
+		if (toolName === "user_context_read" || toolName === "knowledge_read") {
+			const command = args?.command;
+			if (command === "search" || command === "get") {
+				const legacyId = `${toolName.slice(0, -5)}_${command}`;
+				const legacyPolicy = profile.config.tools[legacyId];
+				const policies = [gatewayPolicy && {
+					id: toolName,
+					...gatewayPolicy
+				}, legacyPolicy && {
+					id: legacyId,
+					...legacyPolicy
+				}].filter((policy) => Boolean(policy));
+				const rank = {
+					allow: 0,
+					ask: 1,
+					deny: 2
+				};
+				policies.sort((a, b) => rank[b.mode] - rank[a.mode]);
+				const selected = policies[0];
+				if (!selected) return void 0;
+				const limits = policies.flatMap((policy) => policy.maxCallsPerTurn ? [policy.maxCallsPerTurn] : []);
+				return {
+					...selected,
+					...limits.length ? { maxCallsPerTurn: Math.min(...limits) } : {}
+				};
+			}
+		}
 		if (gatewayPolicy && gatewayPolicy.mode !== "allow") return {
 			id: toolName,
 			...gatewayPolicy

package/dist/src/agent/background-review/run-background-review.js

@@ -4,12 +4,12 @@ import { finishContextExtractionRun } from "../../storage/sqlite/context-extract
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import { loadCompactionSourceSnapshot } from "../../storage/sqlite/transcript-repository.js";
 import { init_sqlite } from "../../storage/sqlite/index.js";
-import { extractTextContent } from "../context/workspace.js";
 import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { getApiKeySync, init_providers, resolveModel } from "../../providers/index.js";
 import { createExtensionAwareStreamFn } from "../../providers/extension-stream-bridge.js";
 import { trackAiUsageStream } from "../../usage/recorder.js";
+import { extractTextContent } from "../context/workspace.js";
 import { getAssertionSlot, listUserAssertions } from "../../user-model/repository.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed } from "../orchestration/llm-turn-retry.js";

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

@@ -2,10 +2,10 @@ import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transa
 import { init_collaboration_rule_repository, listCollaborationRules } from "../../storage/sqlite/collaboration-rule-repository.js";
 import { searchKnowledgeItems } from "../../knowledge-memory/repository.js";
 import "../../knowledge-memory/index.js";
-import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { listUserAssertions } from "../../user-model/repository.js";
 import { calculateExecutionValue } from "../../user-model/importance.js";
 import { canUseAssertion } from "../../user-model/usage-policy.js";
+import { retrievalLexicalSimilarity } from "../../retrieval/textFeatures.js";
 import { getExecutionContextFeedbackScores } from "./audit.js";
 import { buildUserContextBlock } from "../memory/context-fence.js";
 import { randomUUID } from "node:crypto";

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

@@ -1,11 +1,11 @@
 import { TaskRepository, init_task_repository } from "../../tasks/task-repository.js";
+import { knowledgeItemAllowed, listKnowledgeItems, searchKnowledgeItems } from "../../knowledge-memory/repository.js";
+import "../../knowledge-memory/index.js";
+import { ProjectStore } from "../../projects/project-store.js";
+import { getProjectForSession, getProjectWorkspacePathForSession } from "../../projects/workspace.js";
 import { sanitizeForPromptLiteral } from "../prompt/sanitize-for-prompt.js";
 import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
 import { LocalAppStore } from "../../local-apps/store.js";
-import { ProjectStore } from "../../projects/project-store.js";
-import { getProjectForSession, getProjectWorkspacePathForSession } from "../../projects/workspace.js";
-import { knowledgeItemAllowed, listKnowledgeItems, searchKnowledgeItems } from "../../knowledge-memory/repository.js";
-import "../../knowledge-memory/index.js";
 //#region src/agent/context/project-context.ts
 init_task_repository();
 const MAX_TEXT = 1200;

package/dist/src/agent/embedded/run-for-session.js

@@ -6,9 +6,9 @@ import { setTraceIdentity, startObservation, traceOperation, traceRun } from "..
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
 import { appendDynamicPromptSection } from "../prompt/cache-boundary.js";
+import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { runWithEmbeddedExecutionSession } from "./execution-context.js";
 import { resolveAgentTurnTimeoutMs } from "../orchestration/run-agent-turn-with-timeout.js";
-import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { resolvePromptCachePolicy } from "../../providers/prompt-cache-plan.js";
 import { evaluateContextBudget } from "../memory/context-budget.js";
 import { assessContext, recoverContext as recoverContext$1 } from "../memory/context-recovery.js";

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

@@ -1,7 +1,7 @@
-import { executeExternalOperation } from "../../capabilities/runtime/external-operations.js";
-import { canonicalCapabilityJson } from "../../capabilities/runtime/dispatcher.js";
 import { COMPUTER_CONTROL_TOOL, init_src } from "../../../packages/computer-control-contract/src/index.js";
 import { BROWSER_CONTROL_ENDPOINT_TOOL_NAME } from "../../../packages/browser-control-contract/src/index.js";
+import { executeExternalOperation } from "../../capabilities/runtime/external-operations.js";
+import { canonicalCapabilityJson } from "../../capabilities/runtime/dispatcher.js";
 import { externalToolRef, parseExternalToolRef } from "./refs.js";
 import { createHash } from "node:crypto";
 //#region src/agent/external-tools/endpoint-provider.ts

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,9 @@ 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 "../../../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 +26,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 +70,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 +295,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 +414,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 +447,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,
@@ -591,7 +610,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/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;