@xopcai/xopc 0.0.188 → 0.0.190

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

@@ -1,6 +1,7 @@
 import { resolveStateDir } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
 import { getSessionConfig } from "../storage/sqlite/config-repository.js";
 import "../storage/sqlite/index.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
@@ -8,7 +9,7 @@ import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
 import { init_agent_scope, resolveAgentProfileDir } from "./agent-scope.js";
 import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
-import { init_paths, resolveBundledSkillsDir, resolveUserProfilePath } from "../config/paths.js";
+import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
 import { getApiKeySync, getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
@@ -126,6 +127,8 @@ var AgentManager = class {
 			getConfig: () => this.config.config,
 			isEnabledForSession: (sessionKey) => this.isUserContextEnabledForSession(sessionKey),
 			getAgentIdForSession: (sk) => this.agents.get(sk)?.effectiveProfile.agentId ?? "main",
+			getWorkspaceIdForSession: (sk) => this.getResolvedWorkspaceForSession(sk),
+			getProjectIdForSession: (sk) => getSessionMetadata(sk)?.projectId,
 			getMemoryManagerForSession: (sk) => this.getMemoryManagerForSession(sk),
 			getLastAssistantContent: (sk) => this.getLastAssistantContent(sk)
 		});
@@ -142,7 +145,7 @@ var AgentManager = class {
 		});
 	}
 	isUserContextEnabledForSession(sessionKey) {
-		return Boolean(this.config.config?.userContext.enabled && this.config.config.userContext.memory.mode !== "off" && getSessionConfig(sessionKey)?.userContextMode !== "off");
+		return Boolean(this.config.config?.userContext.enabled && getSessionConfig(sessionKey)?.userContextMode !== "off");
 	}
 	computeBaseWorkspacePath() {
 		const cfg = this.config.config;
@@ -225,6 +228,7 @@ var AgentManager = class {
 		return {
 			workspace: this.baseWorkspacePath,
 			extensionRegistry: this.config.extensionRegistry,
+			endpointTools: this.config.endpointTools,
 			getCurrentContext: this.config.getCurrentContext,
 			hookRunner: this.config.hookRunner,
 			bus: this.config.bus,
@@ -271,8 +275,7 @@ var AgentManager = class {
 				for (const n of names) if (isValidSkillEnvVarName(n)) inst.skillEnvPassthroughKeys.add(n.trim());
 			},
 			installSkillFromSource: this.config.installSkillFromSource,
-			installSkillFromMarketplace: this.config.installSkillFromMarketplace,
-			getCodeIntelligenceRuntime: (workspace) => this.workspaceRuntimes.getOrCreate(workspace, resolveEffectiveAgentProfileForSession(this.config.config, this.config.getCurrentContext?.()?.sessionKey).agentId).codeIntelligence
+			installSkillFromMarketplace: this.config.installSkillFromMarketplace
 		};
 	}
 	getMemoryManager() {
@@ -281,13 +284,6 @@ var AgentManager = class {
 	getMemoryManagerForSession(sessionKey) {
 		return this.getWorkspaceRuntimeForSession(sessionKey).memoryManager;
 	}
-	markCodeIntelligenceDirty(sessionKey, paths) {
-		if (paths.length === 0) return;
-		const instance = this.agents.get(sessionKey);
-		const config = this.config.config?.codeIntelligence;
-		if (!instance || !config?.enabled || !config.agentIds.includes(instance.effectiveProfile.agentId)) return;
-		this.getWorkspaceRuntimeForSession(sessionKey).codeIntelligence.markDirty(paths);
-	}
 	/** Build the bounded, policy-filtered context used for this model turn. */
 	prepareUserTurnContext(userMessage, sessionKey, turnId) {
 		return this.userContext.prepare(userMessage, sessionKey, turnId);
@@ -445,7 +441,6 @@ var AgentManager = class {
 		const contextInjection = "always";
 		const { contextFiles } = resolveBootstrapContextSync({
 			profileDir,
-			userProfilePath: resolveUserProfilePath(),
 			config: cfg,
 			sessionKey,
 			excludeHeartbeat: excludeHeartbeat ?? !heartbeatEnabled,
@@ -860,7 +855,6 @@ var AgentManager = class {
 			getMemoryManager: () => rt.memoryManager,
 			getSkillManager: () => rt.skillManager
 		});
-		if (this.config.config?.codeIntelligence?.enabled && this.config.config.codeIntelligence.agentIds.includes(profile.agentId)) rt.codeIntelligence.prime().catch(() => {});
 		const registeredToolNames = tools.map((t) => t.name);
 		const thinkingLevel = profile.thinkingDefault ?? this.config.thinkingLevel ?? "medium";
 		agent = new Agent({

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

@@ -1,6 +1,6 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { summarizeUserUnderstandingQuality } from "../../storage/sqlite/memory-records-repository.js";
+import { summarizeUserUnderstandingQuality } from "../../storage/sqlite/user-context-quality-repository.js";
 import "../../storage/sqlite/index.js";
 import { resolveAdaptiveUnderstandingCadence } from "../memory/understanding/quality.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed } from "../orchestration/llm-turn-retry.js";

package/dist/src/agent/background-review/prompts.d.ts

@@ -1,2 +1,2 @@
-export declare const MEMORY_REVIEW_USER_PROMPT = "Review the conversation above and identify durable user-understanding candidates.\n\nFocus on:\n1. Has the user revealed things about themselves \u2014 persona, desires, preferences, or personal details worth remembering?\n2. Has the user expressed expectations about how you should behave, their work style, emotional-support preferences, boundaries, or how they want you to communicate?\n3. Has the user explicitly corrected a prior assumption? Prefer the correction and do not preserve the contradicted interpretation.\n\nReturn JSON only, with this shape:\n{\"candidates\":[{\"kind\":\"preference\",\"content\":\"...\",\"confidence\":0.8,\"importance\":0.7,\"durability\":\"durable\",\"sensitivity\":\"normal\",\"disclosurePolicy\":\"referenceable\",\"tags\":[\"background-review\"]}]}\n\nAllowed kinds: preference, boundary, relationship, project_context, commitment, routine, personal_logistics, open_question, milestone, current_state, task_lesson, tool_preference, long_term_goal, derived_insight.\nOnly include facts supported by the conversation and likely to matter in a future session. A temporary mood or one-off reaction is current context, not durable identity; omit it unless the user describes a recurring pattern that will matter later. Never include passwords, tokens, credentials, or speculative diagnoses. Use {\"candidates\":[]} when nothing qualifies.";
+export declare const MEMORY_REVIEW_USER_PROMPT = "Review the conversation above and identify durable user-understanding candidates.\n\nFocus on:\n1. Has the user revealed things about themselves \u2014 persona, desires, preferences, or personal details worth remembering?\n2. Has the user expressed expectations about how you should behave, their work style, emotional-support preferences, boundaries, or how they want you to communicate?\n3. Has the user explicitly corrected a prior assumption? Prefer the correction and do not preserve the contradicted interpretation.\n\nReturn JSON only, with this shape:\n{\"candidates\":[{\"kind\":\"preference\",\"content\":\"...\",\"confidence\":0.8,\"importance\":0.7,\"durability\":\"durable\",\"sensitivity\":\"normal\",\"disclosurePolicy\":\"referenceable\",\"tags\":[\"background-review\"]}]}\n\nAllowed kinds: preference, boundary, relationship, project_context, commitment, routine, personal_logistics, open_question, milestone, current_state, task_lesson, tool_preference, long_term_goal, derived_insight.\nOnly include facts supported by the conversation and likely to matter in a future session. A temporary mood or one-off reaction is current context, not durable identity; omit it unless the user describes a recurring pattern that will matter later. Never include passwords, tokens, credentials, or speculative diagnoses. Use {\"candidates\":[]} when nothing qualifies.\n\nDo not turn a request about the current task into user understanding. Exclude requested outputs, follow-up instructions, project-note edits, investigations, and other one-off work. Every candidate must be a complete standalone statement about the user or an enduring pattern; never return a clause fragment beginning with a connector such as \"and\", \"also\", \"\u5E76\u4E14\", \"\u4EE5\u53CA\", or \"\u7684\u4E8B\u9879\". Use long_term_goal only when the user states an enduring personal goal, not when they ask the assistant to create, update, investigate, summarize, or track something.";
 export declare const UNDERSTANDING_REVIEW_SYSTEM_PROMPT = "You are the user-understanding synthesis stage for the same session. You do not chat with the user and cannot write storage directly. Extract only evidence-backed, durable candidates and return strict JSON matching the requested schema.";

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

@@ -10,7 +10,9 @@ Return JSON only, with this shape:
 {"candidates":[{"kind":"preference","content":"...","confidence":0.8,"importance":0.7,"durability":"durable","sensitivity":"normal","disclosurePolicy":"referenceable","tags":["background-review"]}]}
 
 Allowed kinds: preference, boundary, relationship, project_context, commitment, routine, personal_logistics, open_question, milestone, current_state, task_lesson, tool_preference, long_term_goal, derived_insight.
-Only include facts supported by the conversation and likely to matter in a future session. A temporary mood or one-off reaction is current context, not durable identity; omit it unless the user describes a recurring pattern that will matter later. Never include passwords, tokens, credentials, or speculative diagnoses. Use {"candidates":[]} when nothing qualifies.`;
+Only include facts supported by the conversation and likely to matter in a future session. A temporary mood or one-off reaction is current context, not durable identity; omit it unless the user describes a recurring pattern that will matter later. Never include passwords, tokens, credentials, or speculative diagnoses. Use {"candidates":[]} when nothing qualifies.
+
+Do not turn a request about the current task into user understanding. Exclude requested outputs, follow-up instructions, project-note edits, investigations, and other one-off work. Every candidate must be a complete standalone statement about the user or an enduring pattern; never return a clause fragment beginning with a connector such as "and", "also", "并且", "以及", or "的事项". Use long_term_goal only when the user states an enduring personal goal, not when they ask the assistant to create, update, investigate, summarize, or track something.`;
 const UNDERSTANDING_REVIEW_SYSTEM_PROMPT = `You are the user-understanding synthesis stage for the same session. You do not chat with the user and cannot write storage directly. Extract only evidence-backed, durable candidates and return strict JSON matching the requested schema.`;
 //#endregion
 export { MEMORY_REVIEW_USER_PROMPT, UNDERSTANDING_REVIEW_SYSTEM_PROMPT };

package/dist/src/agent/background-review/run-background-review.d.ts

@@ -1,6 +1,7 @@
 import { Agent } from '@earendil-works/pi-agent-core';
 import type { Config } from '../../config/schema.js';
 import type { MemoryManager } from '../memory/manager.js';
+import type { UnderstandingCandidate } from '../memory/understanding/types.js';
 import type { BackgroundReviewSettings } from './settings.js';
 export interface RunBackgroundReviewParams {
     sessionKey: string;
@@ -9,4 +10,5 @@ export interface RunBackgroundReviewParams {
     memoryManager: MemoryManager;
     getConfig: () => Config | undefined;
 }
+export declare function parseUnderstandingCandidates(raw: string): UnderstandingCandidate[];
 export declare function runBackgroundReviewTurn(params: RunBackgroundReviewParams): Promise<void>;

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

@@ -1,11 +1,14 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
+import "../../storage/sqlite/index.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../../auth/sync-provider-auth.js";
 import { getApiKeySync, init_providers } from "../../providers/index.js";
 import { createExtensionAwareStreamFn } from "../../providers/extension-stream-bridge.js";
 import { extractTextContent } from "../context/workspace.js";
 import { resolveAgentTurnTimeoutMs, runAgentTurnWithTimeout } from "../orchestration/run-agent-turn-with-timeout.js";
 import { isAssistantTurnAborted, isAssistantTurnFailed } from "../orchestration/llm-turn-retry.js";
+import { isDurableUnderstandingCandidate } from "../../user-context/understandingQuality.js";
 import { MEMORY_REVIEW_USER_PROMPT, UNDERSTANDING_REVIEW_SYSTEM_PROMPT } from "./prompts.js";
 import { Agent } from "@earendil-works/pi-agent-core";
 //#region src/agent/background-review/run-background-review.ts
@@ -22,14 +25,9 @@ const ALLOWED_UNDERSTANDING_KINDS = new Set([
 	"boundary",
 	"relationship",
 	"project_context",
-	"commitment",
 	"routine",
-	"personal_logistics",
-	"open_question",
-	"milestone",
 	"current_state",
 	"task_lesson",
-	"tool_preference",
 	"long_term_goal",
 	"derived_insight"
 ]);
@@ -61,21 +59,22 @@ function parseUnderstandingCandidates(raw) {
 			const item = value;
 			if (!ALLOWED_UNDERSTANDING_KINDS.has(item.kind)) continue;
 			if (typeof item.content !== "string" || item.content.trim().length < 4) continue;
+			const kind = item.kind;
+			if (!isDurableUnderstandingCandidate(kind, item.content)) continue;
 			const confidence = typeof item.confidence === "number" ? item.confidence : .65;
 			const importance = typeof item.importance === "number" ? item.importance : .5;
 			const durability = item.durability === "ephemeral" || item.durability === "recurring" ? item.durability : "durable";
 			const sensitivity = ALLOWED_SENSITIVITIES.has(item.sensitivity) ? item.sensitivity : "personal";
 			const disclosurePolicy = item.disclosurePolicy === "silent" || item.disclosurePolicy === "ask_before_reference" ? item.disclosurePolicy : "referenceable";
 			output.push({
-				kind: item.kind,
+				kind,
 				content: item.content.trim(),
 				confidence: Math.max(0, Math.min(1, confidence)),
 				importance: Math.max(0, Math.min(1, importance)),
 				explicitness: "inferred",
 				durability,
 				sensitivity,
-				disclosurePolicy,
-				tags: Array.isArray(item.tags) ? item.tags.filter((tag) => typeof tag === "string").slice(0, 8) : ["background-review"]
+				disclosurePolicy
 			});
 		}
 		return output;
@@ -118,9 +117,11 @@ async function runUnderstandingReview(params) {
 	}
 	if (isAssistantTurnAborted(reviewAgent) || isAssistantTurnFailed(reviewAgent)) return;
 	const candidates = parseUnderstandingCandidates(lastAssistantText(reviewAgent));
+	const projectId = getSessionMetadata(sessionKey)?.projectId;
 	await memoryManager.applyUnderstandingCandidates(candidates, {
 		agentId: settings.agentId,
 		sessionKey,
+		...projectId ? { projectId } : {},
 		sourceText: "Background review of the current session transcript",
 		reviewSource: "background"
 	});
@@ -133,4 +134,4 @@ async function runBackgroundReviewTurn(params) {
 	await runUnderstandingReview(params);
 }
 //#endregion
-export { runBackgroundReviewTurn };
+export { parseUnderstandingCandidates, runBackgroundReviewTurn };

package/dist/src/agent/bootstrap/bootstrap-cache.d.ts

@@ -3,7 +3,6 @@ export declare function wasBootstrapContextInjected(sessionKey: string): boolean
 export declare function markBootstrapContextInjected(sessionKey: string): void;
 export declare function getOrLoadBootstrapFiles(params: {
     profileDir: string;
-    userProfilePath?: string;
     sessionKey: string;
 }): Promise<WorkspaceBootstrapFile[]>;
 export declare function clearBootstrapSnapshot(sessionKey: string): void;

package/dist/src/agent/bootstrap/bootstrap-cache.js

@@ -1,4 +1,4 @@
-import { loadProfileBootstrapFiles, loadUserProfileBootstrapFile } from "./load-bootstrap-files.js";
+import { loadProfileBootstrapFiles } from "./load-bootstrap-files.js";
 //#region src/agent/bootstrap/bootstrap-cache.ts
 const cache = /* @__PURE__ */ new Map();
 const bootstrapContextInjected = /* @__PURE__ */ new Set();
@@ -17,11 +17,10 @@ function markBootstrapContextInjected(sessionKey) {
 }
 async function getOrLoadBootstrapFiles(params) {
 	const existing = cache.get(params.sessionKey);
-	const files = [...loadUserProfileBootstrapFile(params.userProfilePath), ...loadProfileBootstrapFiles(params.profileDir)];
-	if (existing && existing.profileDir === params.profileDir && existing.userProfilePath === params.userProfilePath && bootstrapFilesEqual(existing.files, files)) return existing.files;
+	const files = loadProfileBootstrapFiles(params.profileDir);
+	if (existing && existing.profileDir === params.profileDir && bootstrapFilesEqual(existing.files, files)) return existing.files;
 	cache.set(params.sessionKey, {
 		profileDir: params.profileDir,
-		userProfilePath: params.userProfilePath,
 		files
 	});
 	return files;

package/dist/src/agent/bootstrap/bootstrap-files.d.ts

@@ -3,20 +3,17 @@ import type { EmbeddedContextFile, WorkspaceBootstrapFile } from './types.js';
 export { clearAllBootstrapSnapshots, clearBootstrapSnapshot } from './bootstrap-cache.js';
 export declare function resolveBootstrapFilesSync(params: {
     profileDir: string;
-    userProfilePath?: string;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
 }): WorkspaceBootstrapFile[];
 export declare function resolveBootstrapFilesForRun(params: {
     profileDir: string;
-    userProfilePath?: string;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
     warn?: (message: string) => void;
 }): Promise<WorkspaceBootstrapFile[]>;
 export declare function resolveBootstrapContextSync(params: {
     profileDir: string;
-    userProfilePath?: string;
     config?: Config;
     sessionKey?: string;
     excludeHeartbeat?: boolean;
@@ -27,7 +24,6 @@ export declare function resolveBootstrapContextSync(params: {
 };
 export declare function resolveBootstrapContextForRun(params: {
     profileDir: string;
-    userProfilePath?: string;
     config?: Config;
     sessionKey?: string;
     excludeHeartbeat?: boolean;

package/dist/src/agent/bootstrap/bootstrap-files.js

@@ -1,5 +1,5 @@
 import { DEFAULT_HEARTBEAT_FILENAME } from "../context/workspace.js";
-import { loadProfileBootstrapFiles, loadUserProfileBootstrapFile } from "./load-bootstrap-files.js";
+import { loadProfileBootstrapFiles } from "./load-bootstrap-files.js";
 import { clearAllBootstrapSnapshots, clearBootstrapSnapshot, getOrLoadBootstrapFiles, markBootstrapContextInjected, wasBootstrapContextInjected } from "./bootstrap-cache.js";
 import { buildBootstrapContextFiles, resolveBootstrapMaxChars, resolveBootstrapTotalMaxChars } from "./bootstrap-context.js";
 import { filterBootstrapFilesForSession } from "./filter-bootstrap-files.js";
@@ -9,15 +9,14 @@ function filterHeartbeatBootstrapFile(files, exclude) {
 	return files.filter((file) => file.name !== DEFAULT_HEARTBEAT_FILENAME);
 }
 function resolveBootstrapFilesSync(params) {
-	return filterHeartbeatBootstrapFile(filterBootstrapFilesForSession([...loadUserProfileBootstrapFile(params.userProfilePath), ...loadProfileBootstrapFiles(params.profileDir)], params.sessionKey), params.excludeHeartbeat ?? false);
+	return filterHeartbeatBootstrapFile(filterBootstrapFilesForSession(loadProfileBootstrapFiles(params.profileDir), params.sessionKey), params.excludeHeartbeat ?? false);
 }
 async function resolveBootstrapFilesForRun(params) {
 	const sessionKey = params.sessionKey;
 	return filterHeartbeatBootstrapFile(filterBootstrapFilesForSession(sessionKey ? await getOrLoadBootstrapFiles({
 		profileDir: params.profileDir,
-		userProfilePath: params.userProfilePath,
 		sessionKey
-	}) : [...loadUserProfileBootstrapFile(params.userProfilePath), ...loadProfileBootstrapFiles(params.profileDir)], sessionKey), params.excludeHeartbeat ?? false);
+	}) : loadProfileBootstrapFiles(params.profileDir), sessionKey), params.excludeHeartbeat ?? false);
 }
 function resolveBootstrapContextSync(params) {
 	const mode = params.contextInjection ?? "always";

package/dist/src/agent/bootstrap/filter-bootstrap-files.js

@@ -1,16 +1,13 @@
 import { isCronSessionKey, isSubagentSessionKey } from "../../routing/session-key-utils.js";
 import { init_session_key } from "../../routing/session-key.js";
-import { USER_PROFILE_FILENAME, init_paths } from "../../config/paths.js";
 import { DEFAULT_AGENTS_FILENAME, DEFAULT_IDENTITY_FILENAME, DEFAULT_SOUL_FILENAME, DEFAULT_TOOLS_FILENAME } from "../context/workspace.js";
 //#region src/agent/bootstrap/filter-bootstrap-files.ts
-init_paths();
 init_session_key();
 const MINIMAL_BOOTSTRAP_ALLOWLIST = new Set([
 	DEFAULT_AGENTS_FILENAME,
 	DEFAULT_TOOLS_FILENAME,
 	DEFAULT_SOUL_FILENAME,
-	DEFAULT_IDENTITY_FILENAME,
-	USER_PROFILE_FILENAME
+	DEFAULT_IDENTITY_FILENAME
 ]);
 /** Subagent and cron sessions load only the minimal identity and instruction profile. */
 function filterBootstrapFilesForSession(files, sessionKey) {

package/dist/src/agent/bootstrap/load-bootstrap-files.d.ts

@@ -1,5 +1,4 @@
 import type { WorkspaceBootstrapFile } from './types.js';
-export declare function loadUserProfileBootstrapFile(userProfilePath: string | undefined): WorkspaceBootstrapFile[];
 /**
  * Load bootstrap profile Markdown from `agents/<id>/profile/`.
  * Required files emit missing markers; optional files are omitted when absent.

package/dist/src/agent/bootstrap/load-bootstrap-files.js

@@ -1,9 +1,7 @@
-import { USER_PROFILE_FILENAME, init_paths } from "../../config/paths.js";
 import { DEFAULT_AGENTS_FILENAME, DEFAULT_HEARTBEAT_FILENAME, DEFAULT_IDENTITY_FILENAME, DEFAULT_SOUL_FILENAME, DEFAULT_TOOLS_FILENAME, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET, stripFrontMatter } from "../context/workspace.js";
 import { join, resolve } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/agent/bootstrap/load-bootstrap-files.ts
-init_paths();
 const PROFILE_LOAD_ORDER = [
 	DEFAULT_AGENTS_FILENAME,
 	DEFAULT_SOUL_FILENAME,
@@ -19,17 +17,6 @@ function readProfileFile(filePath) {
 		return null;
 	}
 }
-function loadUserProfileBootstrapFile(userProfilePath) {
-	if (!userProfilePath) return [];
-	const filePath = resolve(userProfilePath);
-	const content = readProfileFile(filePath);
-	return content !== null ? [{
-		name: USER_PROFILE_FILENAME,
-		path: filePath,
-		content,
-		missing: false
-	}] : [];
-}
 /**
 * Load bootstrap profile Markdown from `agents/<id>/profile/`.
 * Required files emit missing markers; optional files are omitted when absent.
@@ -55,4 +42,4 @@ function loadProfileBootstrapFiles(profileDir) {
 	return result;
 }
 //#endregion
-export { loadProfileBootstrapFiles, loadUserProfileBootstrapFile };
+export { loadProfileBootstrapFiles };

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

@@ -1,5 +1,5 @@
 import type { AgentProfileMarkdownFilename } from '../context/workspace.js';
-export type BootstrapFileName = AgentProfileMarkdownFilename | 'PROFILE.md';
+export type BootstrapFileName = AgentProfileMarkdownFilename;
 export type WorkspaceBootstrapFile = {
     name: BootstrapFileName;
     path: string;

package/dist/src/agent/client-error-format.d.ts

@@ -16,5 +16,5 @@ export declare function formatAgentRunErrorForClient(rawError: string, context?:
     provider?: string;
     modelRef?: string;
 }): string;
-/** Human-readable text for TUI/CLI when SSE carries structured JSON. */
+/** Human-readable text for TUI/CLI when a run event carries structured JSON. */
 export declare function formatAgentRunErrorForDisplay(content: string): string;

package/dist/src/agent/client-error-format.js

@@ -87,7 +87,7 @@ function formatAgentRunErrorForClient(rawError, context) {
 	}
 	return JSON.stringify(payload);
 }
-/** Human-readable text for TUI/CLI when SSE carries structured JSON. */
+/** Human-readable text for TUI/CLI when a run event carries structured JSON. */
 function formatAgentRunErrorForDisplay(content) {
 	const trimmed = content.trim();
 	if (trimmed.startsWith("Error: ")) return trimmed.slice(7);

package/dist/src/agent/context/workspace-templates/SOUL.md

@@ -34,7 +34,7 @@ Be the assistant you'd actually want to talk to. Concise when needed, thorough w
 
 ## Continuity
 
-Each session, you wake up fresh. These files _are_ your memory. Read them. Update them. They're how you persist.
+These files define your identity and operating principles. Durable user context is provided separately by xopc.
 
 If you change this file, tell the user — it's your soul, and they should know.
 

package/dist/src/agent/external-tools/endpoint-provider.d.ts

@@ -0,0 +1,17 @@
+import type { AgentToolResult } from '@earendil-works/pi-agent-core';
+import type { EndpointToolRuntime } from '../../endpoint-tools/index.js';
+import type { ExternalToolDescriptor, ExternalToolExecutionContext, ExternalToolProvider, ExternalToolSearchHit, ExternalToolTurnContext } from './types.js';
+export interface EndpointToolProviderDeps {
+    runtime: EndpointToolRuntime;
+    getCurrentContext: () => ExternalToolTurnContext | null;
+}
+export declare class EndpointToolProvider implements ExternalToolProvider {
+    private readonly deps;
+    readonly source: "endpoint";
+    constructor(deps: EndpointToolProviderDeps);
+    search(_query: string): Promise<ExternalToolSearchHit[]>;
+    describe(toolRef: string): Promise<ExternalToolDescriptor | undefined>;
+    execute(toolRef: string, args: Record<string, unknown>, _approvalId: string | undefined, context: ExternalToolExecutionContext): Promise<AgentToolResult<Record<string, unknown>>>;
+    private currentEndpoint;
+    private resolve;
+}

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

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

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

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

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

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

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

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

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

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

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

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

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

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