@xopcai/xopc 0.0.180 → 0.0.188

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

@@ -1,92 +1,60 @@
-import { createLogger } from "../../utils/logger/index.js";
-import { init_logger } from "../../utils/logger.js";
-import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE } from "../memory/dreaming/constants.js";
-import { clearStaleDreamingLock, loadDreamingStore, resetDreamingStore } from "../memory/dreaming/short-term-store.js";
+import { isXopcDatabaseOpen } from "../../storage/sqlite/connection.js";
+import { evaluateMemoryReadiness } from "../../user-context/memory-readiness.js";
+import { getMemoryReadiness } from "../../storage/sqlite/memory-readiness-repository.js";
+import { listDreamingRuns } from "../../storage/sqlite/dreaming-repository.js";
+import { listMemorySignals } from "../../storage/sqlite/memory-records-repository.js";
+import "../../storage/sqlite/index.js";
 import { resolveDreamingConfig } from "../memory/dreaming/config.js";
-import path from "node:path";
-import fs from "node:fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/dreaming-tool.ts
-init_logger();
-const log = createLogger("DreamingTool");
-const DreamingSchema = Type.Object({ action: Type.Union([
-	Type.Literal("status"),
-	Type.Literal("reset_store"),
-	Type.Literal("clear_lock")
-]) });
-function textResult(text) {
-	return {
-		content: [{
-			type: "text",
-			text
-		}],
-		details: {}
-	};
-}
-function safeStatMs(ms) {
-	if (typeof ms !== "number" || !Number.isFinite(ms) || ms <= 0) return null;
-	return Math.floor(ms);
-}
-function isoDay(isoLike) {
-	if (!isoLike) return null;
-	return isoLike.match(/^(\d{4}-\d{2}-\d{2})/)?.[1] ?? null;
-}
+const DreamingSchema = Type.Object({ action: Type.Literal("status") });
 function createDreamingTool(deps) {
 	return {
 		name: "dreaming",
 		label: "💤 Dreaming",
-		description: "Inspect and maintain the dreaming promotion state.\n\nActions:\n- status: show config gates and short-term store stats\n- reset_store: clear this agent short-term recall store (.dreams/short-term-recall.json)\n- clear_lock: remove this agent stale promotion lock file (.dreams/short-term-promotion.lock)",
+		description: "Show the structured Dreaming configuration and recent consolidation activity.",
 		parameters: DreamingSchema,
-		async execute(_toolCallId, params) {
-			const action = params.action;
-			const dreamingRoot = deps.getDreamingRoot();
-			const cfg = deps.getConfig();
+		async execute() {
 			const agentId = deps.getAgentId?.();
-			const resolved = resolveDreamingConfig(cfg, agentId);
-			const storePath = path.join(dreamingRoot, SHORT_TERM_RECALL_STORE_RELATIVE);
-			const lockPath = path.join(dreamingRoot, SHORT_TERM_PROMOTION_LOCK_RELATIVE);
-			if (action === "status") {
-				const { store } = await loadDreamingStore({ dreamingRoot });
-				const entries = Object.values(store.entries ?? {});
-				const total = entries.length;
-				const promoted = entries.filter((e) => Boolean(e.promotedAt)).length;
-				const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-				const promotedToday = entries.filter((e) => isoDay(e.promotedAt) === today).length;
-				const lastPromotedAt = entries.map((e) => e.promotedAt).filter((x) => typeof x === "string" && x.length > 0).sort().at(-1);
-				const lockStat = await fs.stat(lockPath).catch(() => null);
-				const lockAgeMs = lockStat && safeStatMs(lockStat.mtimeMs) ? Date.now() - Math.floor(lockStat.mtimeMs) : null;
-				return textResult([
-					"Dreaming status",
-					"",
-					`enabled: ${resolved.enabled ? "true" : "false"}`,
-					`deep.enabled: ${resolved.deep.enabled ? "true" : "false"}`,
-					`cron.frequency: ${resolved.frequency}`,
-					`cron.timezone: ${resolved.timezone ?? "(default)"}`,
-					`deep.minScore: ${resolved.deep.minScore}`,
-					`deep.minRecallCount: ${resolved.deep.minRecallCount}`,
-					`deep.limit: ${resolved.deep.limit}`,
-					"",
-					`agentId: ${agentId ?? "(unknown)"}`,
-					`storePath: ${storePath}`,
-					`entryCount: ${total}`,
-					`promotedCount: ${promoted}`,
-					`promotedToday: ${promotedToday}`,
-					`lastPromotedAt: ${lastPromotedAt ?? "(none)"}`,
-					"",
-					`lockPath: ${SHORT_TERM_PROMOTION_LOCK_RELATIVE}`,
-					`lockPresent: ${lockStat ? "true" : "false"}`,
-					`lockAgeMs: ${lockAgeMs ?? "(n/a)"}`
-				].join("\n"));
-			}
-			if (action === "reset_store") {
-				const before = await resetDreamingStore({ dreamingRoot });
-				log.info({
-					dreamingRoot,
-					before
-				}, "Dreaming store reset");
-				return textResult(`Reset short-term store. Removed ${before} entr${before === 1 ? "y" : "ies"}. Path: ${storePath}`);
-			}
-			return textResult(`${await clearStaleDreamingLock(dreamingRoot) ? "Cleared stale lock." : "No lock present."} Path: ${lockPath}`);
+			const workspaceId = deps.getWorkspace();
+			const readiness = agentId && isXopcDatabaseOpen() ? getMemoryReadiness({
+				agentId,
+				workspaceId
+			}) : evaluateMemoryReadiness({
+				evaluatedTurns: 0,
+				helpfulTurns: 0,
+				recordFeedback: 0,
+				recordErrors: 0,
+				sensitiveFeedback: 0,
+				dreamingRuns: 0,
+				dreamingFailures: 0
+			});
+			const resolved = resolveDreamingConfig(deps.getConfig(), { automaticReady: readiness.ready });
+			const signals = listMemorySignals({
+				workspaceId,
+				limit: 500
+			});
+			const runs = listDreamingRuns({
+				agentId,
+				workspaceId,
+				limit: 20
+			});
+			return {
+				content: [{
+					type: "text",
+					text: JSON.stringify({
+						mode: resolved.mode,
+						phases: resolved.phases,
+						writeDisposition: resolved.writeDisposition,
+						readiness,
+						storage: "sqlite://memory_records",
+						signalCount: signals.length,
+						dreamingSignalCount: signals.filter((signal) => signal.source === "dreaming").length,
+						lastRun: runs[0] ?? null
+					}, null, 2)
+				}],
+				details: {}
+			};
 		}
 	};
 }

package/dist/src/agent/tools/exec-command.d.ts

@@ -1,5 +1,4 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
-import type { GoalEvidenceRecordInput } from './goal-evidence-recorder.js';
 export interface ExecCommandDetails {
     command: string;
     cwd: string;
@@ -25,6 +24,5 @@ export interface ExecCommandUpdateDetails {
 export interface CreateExecCommandToolOptions {
     /** Env var names allowed through prepareSafeToolEnv even if they match secret heuristics. */
     getSkillPassthroughEnvVarNames?: () => string[];
-    recordGoalEvidence?: (input: GoalEvidenceRecordInput) => Promise<void> | void;
 }
 export declare function createExecCommandTool(workspaceCwd: string, options?: CreateExecCommandToolOptions): AgentTool;

package/dist/src/agent/tools/exec-command.js

@@ -20,9 +20,6 @@ function clampTimeoutMs(raw) {
 function clampMaxOutputChars(raw) {
 	return Math.max(1e3, Math.min(5e5, Math.floor(typeof raw === "number" && Number.isFinite(raw) ? raw : DEFAULT_MAX_OUTPUT_CHARS)));
 }
-function isLikelyTestCommand(command) {
-	return /\b(test|vitest|jest|pytest|go test|cargo test|npm test|pnpm test|yarn test|typecheck|type-check|lint)\b/i.test(command);
-}
 function commandStatus(exitCode, timedOut) {
 	if (timedOut) return "timed_out";
 	if (exitCode === 0) return "success";
@@ -182,27 +179,13 @@ function createExecCommandTool(workspaceCwd, options) {
 						truncatedBy: formatted.truncatedBy,
 						outputBytes: formatted.outputBytes
 					};
-					const result = {
+					resolveTool({
 						content: [{
 							type: "text",
 							text: formatted.text
 						}],
 						details
-					};
-					Promise.resolve(options?.recordGoalEvidence?.({
-						kind: timedOut || exitCode !== 0 ? "command" : isLikelyTestCommand(command) ? "test" : "command",
-						title: `Command: ${command.slice(0, 120)}`,
-						summary: formatted.text.slice(0, 2e3),
-						data: {
-							command,
-							cwd: policy.effectiveCwd,
-							exitCode,
-							durationMs,
-							timedOut,
-							truncated: details.truncated,
-							outputBytes: details.outputBytes
-						}
-					})).finally(() => resolveTool(result));
+					});
 				};
 				const abort = () => {
 					timedOut = true;

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

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

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

@@ -9,6 +9,7 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { Model, Api } from '@earendil-works/pi-ai';
 import type { Config } from '../../config/schema.js';
+import type { ExtensionRegistry } from '../../extensions/types/index.js';
 import type { MessageBus } from '../../infra/bus/index.js';
 import { type SkillInstallToolOptions, type SkillInstallToolResult, type MarketplaceSkillInstallToolOptions, type MarketplaceSkillInstallToolResult } from './index.js';
 import type { MemoryManager } from '../memory/manager.js';
@@ -18,7 +19,6 @@ import type { AutomationService } from '../../automations/index.js';
 import type { BrowserRecipeService } from '../../browser/recipes/index.js';
 import type { NotesService } from '../../notes/index.js';
 import type { ProjectService } from '../../projects/index.js';
-import type { WorkItemService } from '../../work-items/index.js';
 import type { LocalAppService } from '../../local-apps/index.js';
 import type { WorkflowRunServiceLike } from '../../workflows/service/workflow-run-service.types.js';
 import type { SkillManager } from '../skills/skill-manager.js';
@@ -26,7 +26,7 @@ import { type ToolExecutorConfig } from './executor.js';
 import type { CodeIntelligenceRuntimeLike } from '../code-intelligence/index.js';
 export interface ToolFactoryDeps {
     workspace: string;
-    extensionRegistry?: any;
+    extensionRegistry?: ExtensionRegistry;
     getCurrentContext: () => {
         channel: string;
         chatId: string;
@@ -53,8 +53,9 @@ export interface ToolFactoryDeps {
     /** Gateway: enables the `xopc_use` product-object tool. */
     getNotesService?: () => NotesService | undefined;
     getProjectService?: () => ProjectService | undefined;
-    getWorkItemService?: () => WorkItemService | undefined;
     getLocalAppService?: () => LocalAppService | undefined;
+    /** Gateway: queues Task execution for xopc_use task start/resume/verify actions. */
+    dispatchTaskRuns?: () => void;
     /** Gateway: starts persisted workflow runs (dedicated chat session per run). */
     getWorkflowRunService?: () => WorkflowRunServiceLike | undefined;
     /** Current session skill indexing (tool gating + allowlist); used by skills_list / skill_view. */
@@ -85,8 +86,6 @@ export interface CreateCoreToolsOptions {
     /** Optional primary model for image tool heuristics. */
     getPrimaryModel?: () => Model<Api>;
     getMemoryManager?: () => MemoryManager;
-    /** Shared user memories directory used for dreaming state (`user/memories`). */
-    dreamingRoot?: string;
     agentId?: string;
     /** When set, registers local skill tools plus marketplace discovery for this workspace. */
     getSkillManager?: () => SkillManager;

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

@@ -4,27 +4,26 @@ import { isXopcDatabaseOpen } from "../../storage/sqlite/connection.js";
 import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/session-task-plan-repository.js";
 import "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
+import { wrapToolsWithProtection } from "./executor.js";
+import { createDefaultExternalToolGatewayTools } from "../external-tools/index.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
 import { createListDirTool } from "./list-dir.js";
 import { createExecCommandTool } from "./exec-command.js";
 import { createApplyPatchTool } from "./apply-patch.js";
 import { createMemoryGetTool, createMemorySearchTool } from "./memory-tool.js";
-import { createCuratedMemoryTool } from "./curated-memory-tool.js";
 import { createSessionSearchTool } from "./session-search-tool.js";
 import { createGrepTool } from "./grep.js";
 import { createFindTool } from "./find.js";
 import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { createWebExtractTool } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
-import { createComposioTools } from "./composio-tool.js";
 import { createSendMediaTool } from "./send-media.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
 import { createTodoTool } from "./todo-tool.js";
 import { createUpdatePlanTool } from "./update-plan-tool.js";
 import { createSessionStatusTool } from "./session-status-tool.js";
-import { resolveDreamingConfig } from "../memory/dreaming/config.js";
 import { createDreamingTool } from "./dreaming-tool.js";
 import { createClarifyTool } from "./clarify-tool.js";
 import { BrowserManager } from "../../browser/manager.js";
@@ -37,7 +36,6 @@ import { createWorkflowTool } from "./workflow-tool.js";
 import "./execute-code-tool.js";
 import { createAutomationTool } from "./automation-tool.js";
 import { createBrowserRecipeTool } from "./browser-recipe-tool.js";
-import { createGoalTool } from "./goal-tool.js";
 import { createXopcUseTool } from "./xopc-use-tool.js";
 import { createSkillViewTool, createSkillsListTool } from "./skills-tools.js";
 import { createSkillManageTool } from "./skill-manage-tool.js";
@@ -50,14 +48,10 @@ import { createManagedJobTool } from "./managed-job-tool.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool } from "./image-generate-tool.js";
 import "./index.js";
-import { shouldRegisterCuratedMemoryTool } from "../memory/memory-config.js";
 import { createBrowserUseTool } from "./browser/tool/browser-use-tool.js";
 import { createWorkflowCatalog } from "../workflow/catalog.js";
-import { resolveDreamingRoot } from "../memory/dreaming/scope.js";
-import { wrapToolsWithProtection } from "./executor.js";
 import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { createTextToSpeechTool } from "./tts-tool.js";
-import { createGoalEvidenceRecorder } from "./goal-evidence-recorder.js";
 import { getAgentCapabilityToolNames } from "../capabilities/registry.js";
 import "../capabilities/index.js";
 import { isCodeIntelligenceEnabledForAgent } from "../code-intelligence/tool-gating.js";
@@ -169,9 +163,7 @@ var AgentToolsFactory = class {
 		const primary = getPrimary?.();
 		const modelHasVision = primary?.input?.includes("image") ?? false;
 		const cfg = this.deps.getConfig?.();
-		const dreamingRoot = options?.dreamingRoot ?? (cfg ? resolveDreamingRoot() : workspace);
 		const browserEnabled = cfg?.browser?.enabled !== false;
-		const recordGoalEvidence = createGoalEvidenceRecorder({ getSessionKey: () => this.deps.getCurrentContext()?.sessionKey });
 		const imageTool = createImageTool({
 			config: cfg,
 			workspace,
@@ -186,21 +178,21 @@ var AgentToolsFactory = class {
 		const codeIntelligenceConfig = cfg?.codeIntelligence;
 		const agentId = options?.agentId;
 		const codeIntelligenceTools = isCodeIntelligenceEnabledForAgent(codeIntelligenceConfig, agentId) && this.deps.getCodeIntelligenceRuntime ? createCodeIntelligenceTools({ getRuntime: () => this.deps.getCodeIntelligenceRuntime(workspace) }) : [];
-		const optionalTools = [
-			imageTool,
-			imageGenerateTool,
-			...createComposioTools({
-				getConfig: () => this.deps.getConfig?.(),
-				getCurrentContext: this.deps.getCurrentContext,
-				agentId
-			})
-		].filter((t) => t != null);
-		const readTool = createReadFileTool(workspace, { profileMarkdownRoot: options?.profileMarkdownRoot });
-		const writeTool = createWriteFileTool(workspace, {
-			profileMarkdownRoot: options?.profileMarkdownRoot,
-			recordGoalEvidence
+		const externalTools = createDefaultExternalToolGatewayTools({
+			workspace,
+			getConfig: () => this.deps.getConfig?.(),
+			getCurrentContext: this.deps.getCurrentContext,
+			agentId,
+			extensionRegistry: this.deps.extensionRegistry,
+			disabledTools: disabled,
+			hookRunner: this.deps.hookRunner,
+			toolExecutorConfig: this.deps.toolExecutorConfig,
+			getMemoryManager: getMemMgr
 		});
-		const applyPatchTool = createApplyPatchTool(workspace, { recordGoalEvidence });
+		const optionalTools = [imageTool, imageGenerateTool].filter((t) => t != null);
+		const readTool = createReadFileTool(workspace, { profileMarkdownRoot: options?.profileMarkdownRoot });
+		const writeTool = createWriteFileTool(workspace, { profileMarkdownRoot: options?.profileMarkdownRoot });
+		const applyPatchTool = createApplyPatchTool(workspace);
 		const listDir = createListDirTool(workspace);
 		const grep = createGrepTool(workspace);
 		const find = createFindTool(workspace);
@@ -208,7 +200,6 @@ var AgentToolsFactory = class {
 			createSessionStatusTool(),
 			createDreamingTool({
 				getWorkspace: () => workspace,
-				getDreamingRoot: () => dreamingRoot,
 				getConfig: () => this.deps.getConfig?.(),
 				getAgentId: () => options?.agentId
 			}),
@@ -235,6 +226,7 @@ var AgentToolsFactory = class {
 				}
 			}),
 			createUpdatePlanTool(),
+			...externalTools,
 			...getSkillMgr ? [
 				createSkillsListTool({
 					getSkillManager: getSkillMgr,
@@ -267,10 +259,7 @@ var AgentToolsFactory = class {
 			listDir,
 			grep,
 			find,
-			createExecCommandTool(workspace, {
-				getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,
-				recordGoalEvidence
-			}),
+			createExecCommandTool(workspace, { getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames }),
 			createManagedJobTool(workspace, () => this.deps.getCurrentContext()?.sessionKey, this.deps.getSkillPassthroughEnvVarNames),
 			createWebSearchTool(() => this.deps.getConfig?.()),
 			createWebFetchTool(() => this.deps.getConfig?.()),
@@ -288,18 +277,13 @@ var AgentToolsFactory = class {
 				getConfig: () => this.deps.getConfig?.()
 			})] : [],
 			...getMemMgr ? [createMemorySearchTool({
-				workspaceDir: workspace,
-				dreamingRoot,
 				getMemoryManager: () => getMemMgr(),
 				getScope: () => ({
 					...options?.agentId ? { agentId: options.agentId } : {},
 					workspaceId: workspace,
 					...this.deps.getCurrentContext?.()?.sessionKey ? { sessionKey: this.deps.getCurrentContext().sessionKey } : {}
-				}),
-				shouldRecordDreamingRecalls: () => resolveDreamingConfig(this.deps.getConfig?.(), options?.agentId).enabled
+				})
 			}), createMemoryGetTool({
-				workspaceDir: workspace,
-				dreamingRoot,
 				getMemoryManager: () => getMemMgr(),
 				getScope: () => ({
 					...options?.agentId ? { agentId: options.agentId } : {},
@@ -307,8 +291,6 @@ var AgentToolsFactory = class {
 					...this.deps.getCurrentContext?.()?.sessionKey ? { sessionKey: this.deps.getCurrentContext().sessionKey } : {}
 				})
 			})] : [],
-			...getMemMgr && shouldRegisterCuratedMemoryTool(this.deps.getConfig?.()) ? [createCuratedMemoryTool(() => getMemMgr())] : [],
-			...getMemMgr?.().getAdditionalTools() ?? [],
 			...this.deps.getSessionStore && getPrimary ? [createSessionSearchTool({
 				getSessionStore: this.deps.getSessionStore,
 				getPrimaryModel: getPrimary,
@@ -316,16 +298,16 @@ var AgentToolsFactory = class {
 			})] : [],
 			...this.deps.getAutomationService ? [createAutomationTool({ getAutomationService: this.deps.getAutomationService })] : [],
 			...browserEnabled && this.deps.getBrowserRecipeService ? [createBrowserRecipeTool({ getBrowserRecipeService: this.deps.getBrowserRecipeService })] : [],
-			...this.deps.getProjectService || this.deps.getNotesService || this.deps.getWorkItemService || this.deps.getLocalAppService ? [createXopcUseTool({
+			...this.deps.getAutomationService || this.deps.getProjectService || this.deps.getNotesService || this.deps.getLocalAppService || this.deps.dispatchTaskRuns ? [createXopcUseTool({
 				getConfig: () => this.deps.getConfig?.(),
 				getCurrentAgentId: () => options.agentId,
 				getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
+				getAutomationService: this.deps.getAutomationService,
 				getNotesService: this.deps.getNotesService,
 				getProjectService: this.deps.getProjectService,
-				getWorkItemService: this.deps.getWorkItemService,
-				getLocalAppService: this.deps.getLocalAppService
+				getLocalAppService: this.deps.getLocalAppService,
+				dispatchTaskRuns: this.deps.dispatchTaskRuns
 			})] : [],
-			createGoalTool({ getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey }),
 			...browserEnabled ? [createBrowserUseTool({
 				getManager: () => this.ensureBrowserManager(),
 				getPageForTask: () => this.acquireBrowserPage(),
@@ -362,16 +344,7 @@ var AgentToolsFactory = class {
 		return ["create_desktop_pet"];
 	}
 	createAllTools(coreOptions) {
-		const coreTools = this.createCoreTools(coreOptions);
-		const disableExtensions = coreOptions?.disabledTools?.has("extensions");
-		let bundled;
-		if (!this.deps.extensionRegistry || disableExtensions) bundled = coreTools;
-		else {
-			const extensionTools = this.deps.extensionRegistry.getAllTools();
-			log.info({ count: extensionTools.length }, "Loaded extension tools");
-			bundled = [...coreTools, ...extensionTools];
-		}
-		return wrapToolsWithProtection(bundled, this.deps.toolExecutorConfig);
+		return wrapToolsWithProtection(this.createCoreTools(coreOptions), this.deps.toolExecutorConfig);
 	}
 };
 function filterToolsByDisabledSet(tools, disabled) {

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

@@ -6,14 +6,12 @@ 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 { createMemorySearchTool, createMemoryGetTool, type MemoryToolOptions, } from './memory-tool.js';
-export { createCuratedMemoryTool } from './curated-memory-tool.js';
 export { createSessionSearchTool } from './session-search-tool.js';
 export { grepTool, createGrepTool, type GrepToolInput, type GrepToolDetails, } from './grep.js';
 export { findTool, createFindTool, type FindToolInput, type FindToolDetails, } from './find.js';
 export { createWebSearchTool, createWebFetchTool } from './web.js';
 export { createWebExtractTool, stripHtmlBoilerplate, DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, } from './web-extract.js';
 export { createMessageTool } from './communication.js';
-export { createComposioTools } from './composio-tool.js';
 export { createSendMediaTool } from './send-media.js';
 export { createReadMediaTool } from './media-read-tool.js';
 export { createCreateShareTool, isShareToolAvailable, type CreateShareToolDeps, } from './create-share-tool.js';
@@ -28,7 +26,6 @@ export { createWorkflowTool, type WorkflowToolDeps, type WorkflowToolInput } fro
 export { createExecuteCodeTool, buildSandboxToolMap, SANDBOX_ALLOWED_TOOLS, } from './execute-code-tool.js';
 export { createAutomationTool, type AutomationToolDeps } from './automation-tool.js';
 export { createBrowserRecipeTool } from './browser-recipe-tool.js';
-export { createGoalTool, type GoalToolOptions } from './goal-tool.js';
 export { createXopcUseTool, type XopcUseToolDeps, type XopcUseToolInput } from './xopc-use-tool.js';
 export { createSkillsListTool, createSkillViewTool, type SkillsToolsDeps } from './skills-tools.js';
 export { createSkillManageTool, type SkillManageToolDeps } from './skill-manage-tool.js';

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

@@ -8,14 +8,12 @@ import { createExecCommandTool } from "./exec-command.js";
 import { fuzzyFindText, generateDiffString, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings, stripBom } from "./edit-diff.js";
 import { createApplyPatchTool } from "./apply-patch.js";
 import { createMemoryGetTool, createMemorySearchTool } from "./memory-tool.js";
-import { createCuratedMemoryTool } from "./curated-memory-tool.js";
 import { createSessionSearchTool } from "./session-search-tool.js";
 import { createGrepTool, grepTool } from "./grep.js";
 import { createFindTool, findTool } from "./find.js";
 import { createWebFetchTool, createWebSearchTool } from "./web.js";
 import { DEFAULT_WEB_EXTRACT_MAX_LENGTH, MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT, createWebExtractTool, stripHtmlBoilerplate } from "./web-extract.js";
 import { createMessageTool } from "./communication.js";
-import { createComposioTools } from "./composio-tool.js";
 import { createSendMediaTool } from "./send-media.js";
 import { createReadMediaTool } from "./media-read-tool.js";
 import { createCreateShareTool, isShareToolAvailable } from "./create-share-tool.js";
@@ -32,7 +30,6 @@ import { createWorkflowTool } from "./workflow-tool.js";
 import { SANDBOX_ALLOWED_TOOLS, buildSandboxToolMap, createExecuteCodeTool } from "./execute-code-tool.js";
 import { createAutomationTool } from "./automation-tool.js";
 import { createBrowserRecipeTool } from "./browser-recipe-tool.js";
-import { createGoalTool } from "./goal-tool.js";
 import { createXopcUseTool } from "./xopc-use-tool.js";
 import { createSkillViewTool, createSkillsListTool } from "./skills-tools.js";
 import { createSkillManageTool } from "./skill-manage-tool.js";
@@ -45,4 +42,4 @@ import { createManagedJobTool } from "./managed-job-tool.js";
 import { resolveImageModelConfigForTool } from "../image/tool-model-config.js";
 import { createImageTool } from "./image-tool.js";
 import { createImageGenerateTool, resolveImageGenerationModelConfigForTool } from "./image-generate-tool.js";
-export { BrowserManager, 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, SANDBOX_ALLOWED_TOOLS, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, buildSandboxToolMap, createApplyPatchTool, createAutomationTool, createBrowserRecipeTool, createClarifyTool, createCodeIntelligenceTools, createComposioTools, createCreateShareTool, createCuratedMemoryTool, createDelegateTool, createDesktopPetTool, createDreamingTool, createExecCommandTool, createExecuteCodeTool, createFindTool, createGoalTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createManagedJobTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, createWorkflowTool, createWriteFileTool, createXopcUseTool, findTool, formatSize, fuzzyFindText, generateDiffString, getToolMetadata, grepTool, isShareToolAvailable, listDirTool, normalizeForFuzzyMatch, normalizeToLF, resolveImageGenerationModelConfigForTool, resolveImageModelConfigForTool, resolveToolLockMode, restoreLineEndings, stripBom, stripHtmlBoilerplate, truncateHead, truncateLine, truncateTail, writeFileTool };
+export { BrowserManager, 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, SANDBOX_ALLOWED_TOOLS, TodoStore, ToolConcurrencyController, assertBrowserUrlAllowed, buildSandboxToolMap, createApplyPatchTool, createAutomationTool, createBrowserRecipeTool, createClarifyTool, createCodeIntelligenceTools, createCreateShareTool, createDelegateTool, createDesktopPetTool, createDreamingTool, createExecCommandTool, createExecuteCodeTool, createFindTool, createGrepTool, createImageGenerateTool, createImageTool, createListDirTool, createManagedJobTool, createMemoryGetTool, createMemorySearchTool, createMessageTool, createReadFileTool, createReadMediaTool, createSendMediaTool, createSessionSearchTool, createSessionStatusTool, createSkillInstallTool, createSkillManageTool, createSkillViewTool, createSkillsListTool, createSkillsMarketplaceSearchTool, createTodoTool, createToolManualTool, createUpdatePlanTool, createWebExtractTool, createWebFetchTool, createWebSearchTool, 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/managed-job-tool.js

@@ -113,7 +113,7 @@ const ManagedJobSchema = Type.Union([
 		action: Type.Literal("cancel"),
 		jobId: Type.String()
 	})
-]);
+], { type: "object" });
 function registry() {
 	return resolveGlobalSingleton(MANAGED_JOB_REGISTRY_KEY, () => new ManagedJobRegistry());
 }

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

@@ -2,11 +2,8 @@ import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { MemoryManager } from '../memory/manager.js';
 import type { MemoryScope } from '../memory/types.js';
 export interface MemoryToolOptions {
-    workspaceDir: string;
-    dreamingRoot: string;
     getMemoryManager: () => MemoryManager;
     getScope?: () => Partial<MemoryScope>;
-    shouldRecordDreamingRecalls?: () => boolean;
 }
 export declare function createMemorySearchTool(options: MemoryToolOptions): AgentTool;
 export declare function createMemoryGetTool(options: MemoryToolOptions): AgentTool;

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

@@ -1,4 +1,3 @@
-import { recordDreamingRecalls } from "../memory/dreaming/short-term-store.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/memory-tool.ts
 const MemorySearchSchema = Type.Object({
@@ -7,11 +6,11 @@ const MemorySearchSchema = Type.Object({
 	minScore: Type.Optional(Type.Number())
 });
 function createMemorySearchTool(options) {
-	const { dreamingRoot, getMemoryManager } = options;
+	const { getMemoryManager } = options;
 	return {
 		name: "memory_search",
 		label: "🔍 Memory Search",
-		description: "Mandatory recall step: search indexed profile, curated, and session memory sources before answering questions about prior work, decisions, dates, people, preferences, or todos; returns top snippets with source path + lines.",
+		description: "Search structured user-understanding records before answering questions about prior work, decisions, dates, people, preferences, or todos; returns ranked snippets with stable record ids.",
 		parameters: MemorySearchSchema,
 		async execute(_toolCallId, params, _signal) {
 			const { query, maxResults, minScore } = params;
@@ -29,31 +28,17 @@ function createMemorySearchTool(options) {
 					content: result.snippet,
 					metadata: {
 						providerId: result.citation.providerId,
-						path: result.citation.path,
-						lineStart: result.citation.lineStart,
-						lineEnd: result.citation.lineEnd
+						query
 					}
 				});
-				if (options.shouldRecordDreamingRecalls?.() !== false) recordDreamingRecalls({
-					dreamingRoot,
-					query,
-					matches: results.map((entry) => ({
-						file: entry.citation.path ?? entry.record.source.path ?? entry.record.id,
-						lines: entry.snippet,
-						score: entry.score,
-						lineNumbers: entry.citation.lineStart != null ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart] : []
-					}))
-				}).catch(() => {});
 				const withCitations = results.map((entry) => ({
 					id: entry.record.id,
 					ownerAgentId: entry.record.provenance.sourceAgentId,
 					kind: entry.record.kind,
-					file: entry.citation.path ?? entry.record.source.path,
-					lines: entry.snippet,
+					content: entry.snippet,
 					score: entry.score,
-					lineNumbers: entry.citation.lineStart != null ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart] : [],
-					citation: `${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ""}` : ""}`,
-					snippet: `${entry.snippet.trim()}\n\nSource: ${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ""}` : ""}`
+					citation: entry.record.id,
+					snippet: `${entry.snippet.trim()}\n\nMemory record: ${entry.record.id}`
 				}));
 				return {
 					content: [{
@@ -78,34 +63,28 @@ function createMemorySearchTool(options) {
 		}
 	};
 }
-const MemoryGetSchema = Type.Object({
-	path: Type.String(),
-	from: Type.Optional(Type.Number()),
-	lines: Type.Optional(Type.Number())
-});
+const MemoryGetSchema = Type.Object({ id: Type.String() });
 function createMemoryGetTool(options) {
 	const { getMemoryManager } = options;
 	return {
 		name: "memory_get",
 		label: "📄 Memory Get",
-		description: "Safe snippet read from a source path returned by memory_search, with optional from/lines; pull only the needed lines and keep context small.",
+		description: "Read one structured memory record by an id returned from memory_search.",
 		parameters: MemoryGetSchema,
 		async execute(_toolCallId, params, _signal) {
-			const { path, from, lines } = params;
+			const { id } = params;
 			try {
 				const result = await getMemoryManager().read({
-					path,
-					from,
-					lines,
+					id,
 					scope: options.getScope?.()
 				});
 				if (!result) return {
 					content: [{
 						type: "text",
-						text: `File not found: ${path}`
+						text: `Memory record not found: ${id}`
 					}],
 					details: {
-						path,
+						id,
 						text: ""
 					}
 				};
@@ -115,9 +94,8 @@ function createMemoryGetTool(options) {
 						text: result.record.content
 					}],
 					details: {
-						path,
-						text: result.record.content,
-						lineNumbers: result.lineNumbers
+						id,
+						record: result.record
 					}
 				};
 			} catch (err) {

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

@@ -6,7 +6,7 @@ function createToolManualTool() {
 	return {
 		name: "tool_manual",
 		label: "📘 Tool Manual",
-		description: "Load built-in usage manuals for complex tools. Use before non-trivial use of tools such as browser_use.",
+		description: "Load built-in usage manuals for complex tools. Use before non-trivial use of tools such as browser_use or xopc_use.",
 		parameters: ToolManualSchema,
 		async execute(_toolCallId, params) {
 			const toolName = params.tool.trim();