Function createCtxMemoryTool

packages/pi-plugin/src/tools/ctx-memory.ts:270–758

(
	deps: CtxMemoryToolDeps,
)

}

export function createCtxMemoryTool(
	deps: CtxMemoryToolDeps,
): ToolDefinition<typeof ParamsSchema> {
	const dreamerAllowed = deps.allowDreamerActions === true;
	const description = dreamerAllowed
		? `${CTX_MEMORY_DESCRIPTION}\n- list: enumerate stored memories (maintenance sessions).`
		: CTX_MEMORY_DESCRIPTION;

	return {
		name: "ctx_memory",
		label: "Magic Context: Memory",
		description,
		parameters: ParamsSchema,
		async execute(
			_toolCallId,
			params: CtxMemoryParams,
			_signal,
			_onUpdate,
			ctx,
		) {
			// Gate dreamer-only actions on the allowlist flag. Mirrors
			// OpenCode's `if (toolContext.agent !== DREAMER_AGENT && !allowedActions.includes(args.action))`.
			if (!dreamerAllowed && DREAMER_ONLY_ACTIONS.has(params.action)) {
				return err(
					`Error: Action '${params.action}' is not allowed in this context.`,
				);
			}

			const projectIdentity = resolveProjectIdentity(ctx.cwd);
			await deps.ensureProjectRegistered?.(ctx.cwd, deps.db);
			const workspaceIdentitySet = resolveWorkspaceIdentitySet(
				deps.db,
				projectIdentity,
			);
			const expandedWorkspace = expandWorkspaceIdentitySetWithAliases(
				deps.db,
				workspaceIdentitySet.identities,
			);
			const workspaceVisibleIdentities =
				workspaceIdentitySet.identities.length > 1
					? expandedWorkspace.expandedIdentities
					: workspaceIdentitySet.identities;
			const targetIdentityForStoredPath = (rawProjectPath: string) =>
				workspaceIdentitySet.identities.length > 1
					? (resolveStoredPathWorkspaceIdentity(
							rawProjectPath,
							workspaceIdentitySet.identities,
							expandedWorkspace.canonicalIdentityByStoredPath,
						) ?? normalizeStoredProjectPath(rawProjectPath))
					: normalizeStoredProjectPath(rawProjectPath);
			// The workspace's share-category policy, identical to the render path
			// (resolveWorkspaceRenderContextPi): null = share all categories.
			const toolShareCategories =
				workspaceIdentitySet.identities.length > 1
					? resolveWorkspaceShareCategories(deps.db, projectIdentity)
					: null;
			// Tool visibility MUST match render visibility, or the agent could
			// mutate (update/archive) a foreign workspace memory it can't even